Vianmääritys

Ongelmia, joita on havaittu ajettaessa Ayakaleaf Prota Docker Desktopilla macOS:ssä, ja miten ne tarkistetaan.

​

Alustus epäonnistuu virheeseen invalid command code

bin/init ilmoittaa sed: ... invalid command code, kun se löytää macOS:n BSD sedin. Lisää GNU sed PATH-muuttujaan sivun 1. Lataa Toolkit mukaisesti ja tarkista sed --version.

Epäonnistunut alustus voi jättää kaikki kolme tiedostoa hakemistoon config/ tyhjällä OVERLEAF_INVITE_TOKEN_SECRET-arvolla. bin/init-komennon uudelleenajo ilmoittaa silloin Config files already exist. Jos kyseessä on uusi asennus, jota ei ole koskaan käynnistetty, siirrä kolme tiedostoa varmuuskopiohakemistoon ja suorita bin/init uudelleen. Olemassa olevan instanssin kohdalla säilytä sen määritykset ja salaisuudet, äläkä poista sen tiedostoja saadaksesi bin/init-komennon toimimaan uudelleen.

​

MongoDB käynnistyy jatkuvasti uudelleen

Lue MongoDB:n lokit ja Docker-virtuaalikoneen ytimen versio:

bin/docker-compose logs --tail=100 mongo
docker info --format '{{.KernelVersion}}'

Jos lokissa mainitaan Linux-ytimen yhteensopimattomuus, noudata kohtaa Tarkista Docker-virtuaalikoneen Linux-ydin ja suorita bin/up -d uudelleen. Pelkkä poistumiskoodi 137 ei todista, että MongoDB:ltä loppui muisti: tarkista kontin tila ja lokit. Vanhemmasta Docker Desktopin MongoDB-ongelmasta katso myös Vianmääritys.

​

Docker-daemoniin ei saada yhteyttä

Käynnistä Docker Desktop ja tarkista valittu Docker-konteksti, katso 0. Docker Desktopin asennus. Jos docker info toimii mutta käännökset eivät tavoita Dockeria, tarkista socket-asetukset tiedostossa config/overleaf.rc ja lue clsi-lokit. Macin toimiva Docker CLI ei todista, että sovelluksen socket-liitos on oikein.

​

Sivu avautuu, mutta käännökset epäonnistuvat

Tarkista, että TeX Live -image on olemassa paikallisesti ja vastaa Docker-moottorin arkkitehtuuria:

docker image inspect ghcr.io/ayaka-notes/texlive-full:2026.1 \
  --format '{{.Os}}/{{.Architecture}}'
bin/logs -f clsi

Apple siliconilla imagen pitäisi olla linux/arm64. Tarkista, että SERVER_PRO ja SIBLING_CONTAINERS_ENABLED ovat molemmat true, ja ota sitten muutokset käyttöön komennolla bin/up -d. Jos lokit ilmoittavat puuttuvasta käännöshakemistosta, tarkista Docker Desktopin tiedostojen jakaminen ja OVERLEAF_DATA_PATH-sijainti. Älä poista hiekkalaatikkokäännöksiä käytöstä peittääksesi liitosvirheen.

​

Not a directory, tai bind-liitos puuttuu

Isännän tiedosto, jonka override liittää, on ehkä poistettu, tai Docker on voinut luoda hakemiston sinne, missä tiedoston pitäisi olla. Tarkista lähdepolku isännällä ja se, odottaako liitos tiedostoa vai hakemistoa. Palauta määritystiedosto ennen kuin luot kontin uudelleen. Hakemistoon /tmp tehty asennus voi kohdata tämän, kun macOS poistaa väliaikaistiedostoja.

​

Portti- tai konttinimiristiriidat

Jos portti 8080 on käytössä, valitse toinen portti tiedostossa config/overleaf.rc, aseta OVERLEAF_SITE_URL vastaamaan sitä ja suorita bin/up -d uudelleen.

Toolkit antaa konteilleen kiinteät nimet, kuten sharelatex, mongo ja redis. Pelkkä PROJECT_NAME-arvon muuttaminen ei tee kahdesta Toolkit-asennuksesta toisistaan riippumattomia. Ennen kuin käynnistät toisen instanssin, tarkista docker ps -a ja käytä Compose-overridessa muita konttinimiä, toista porttia ja erillisiä datahakemistoja. Älä poista olemassa olevan käyttöönoton kontteja tai dataa nimiristiriidan ratkaisemiseksi.

​

Instanssi ei ole tavoitettavissa jonkin ajan kuluttua

Mac meni todennäköisesti lepotilaan, tai Docker Desktop suljettiin. Katso Pidä instanssi saatavilla.

​

bin/doctor sanoo, että tämä ei ole Linux, tai pyytää Quay-kirjautumista

Molemmat varoitukset ovat odotettuja macOS:ssä julkisen imagen kanssa, katso 2. Tutustu Toolkitiin. Tarkista sen sijaan imagehaut, palveluiden tila ja käännösten tulokset, äläkä jätä raportin muita virheitä huomiotta.