> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://ayakaleaf-pro.mintlify.site/fi/on-premises/installation/using-docker-compose/macos/1.-download-the-toolkit.md) 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:

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

Jos lokissa mainitaan Linux-ytimen yhteensopimattomuus, noudata kohtaa [Tarkista Docker-virtuaalikoneen Linux-ydin](https://ayakaleaf-pro.mintlify.site/fi/on-premises/installation/using-docker-compose/macos/5.-personalizing-your-instance.md#check-the-docker-vms-linux-kernel) 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](https://ayakaleaf-pro.mintlify.site/fi/on-premises/support/troubleshooting.md).

### Docker-daemoniin ei saada yhteyttä

Käynnistä Docker Desktop ja tarkista valittu Docker-konteksti, katso [0. Docker Desktopin asennus](https://ayakaleaf-pro.mintlify.site/fi/on-premises/installation/using-docker-compose/macos/0.-setup-docker-desktop.md). 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:

```bash theme={null}
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](https://ayakaleaf-pro.mintlify.site/fi/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md#keep-the-instance-available).

### `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](https://ayakaleaf-pro.mintlify.site/fi/on-premises/installation/using-docker-compose/macos/2.-familiarize-yourself-with-the-toolkit.md). Tarkista sen sijaan imagehaut, palveluiden tila ja käännösten tulokset, äläkä jätä raportin muita virheitä huomiotta.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.