> ## 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.

# Probleemoplossing

> Problemen die optreden bij het draaien van Ayakaleaf Pro met Docker Desktop op macOS, en hoe je ze controleert.

### Initialisatie mislukt met invalid command code

`bin/init` meldt `sed: ... invalid command code` wanneer het de BSD sed van macOS aantreft. Zet GNU sed op het `PATH` zoals in [1. De Toolkit downloaden](https://ayakaleaf-pro.mintlify.site/nl/on-premises/installation/using-docker-compose/macos/1.-download-the-toolkit.md) en controleer `sed --version`.

Een mislukte initialisatie kan alle drie de bestanden in `config/` achterlaten met een lege `OVERLEAF_INVITE_TOKEN_SECRET`. Als je `bin/init` dan opnieuw uitvoert, meldt het `Config files already exist`. Verplaats bij een nieuwe installatie die nog nooit is gestart de drie bestanden naar een back-upmap en voer `bin/init` opnieuw uit. Behoud bij een bestaande instantie de configuratie en geheimen, en verwijder de bestanden niet om `bin/init` opnieuw te kunnen uitvoeren.

### MongoDB blijft opnieuw opstarten

Lees de MongoDB-logs en de kernelversie van de Docker-VM:

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

Als het log de incompatibiliteit met de Linux-kernel noemt, volg dan [De Linux-kernel van de Docker-VM controleren](https://ayakaleaf-pro.mintlify.site/nl/on-premises/installation/using-docker-compose/macos/5.-personalizing-your-instance.md#check-the-docker-vms-linux-kernel) en voer `bin/up -d` opnieuw uit. Exitcode `137` alleen bewijst niet dat MongoDB geen geheugen meer had: controleer de status van de container en de logs. Zie voor een ouder MongoDB-probleem op Docker Desktop ook [Probleemoplossing](https://ayakaleaf-pro.mintlify.site/nl/on-premises/support/troubleshooting.md).

### Kan geen verbinding maken met de Docker-daemon

Start Docker Desktop en controleer de geselecteerde Docker-context; zie [0. Docker Desktop installeren](https://ayakaleaf-pro.mintlify.site/nl/on-premises/installation/using-docker-compose/macos/0.-setup-docker-desktop.md). Als `docker info` werkt maar compilaties Docker niet kunnen bereiken, controleer dan de socketinstellingen in `config/overleaf.rc` en lees de `clsi`-logs. Een werkende Docker CLI op de Mac bewijst niet dat de socketmount van de applicatie correct is.

### De pagina opent, maar compilaties mislukken

Controleer of de TeX Live-image lokaal bestaat en overeenkomt met de architectuur van de Docker-engine:

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

Op Apple silicon moet de image `linux/arm64` zijn. Controleer of `SERVER_PRO` en `SIBLING_CONTAINERS_ENABLED` allebei `true` zijn en pas wijzigingen daarna toe met `bin/up -d`. Als de logs een ontbrekende compilatiemap melden, controleer dan het delen van bestanden in Docker Desktop en de locatie van `OVERLEAF_DATA_PATH`. Schakel sandbox-compilaties niet uit om een mislukte mount te verbergen.

### Not a directory, of een bind-mount ontbreekt

Een hostbestand dat een override mount, is mogelijk verwijderd, of Docker heeft een map aangemaakt waar het bestand zou moeten staan. Controleer het bronpad op de host en of de mount een bestand of een map verwacht. Herstel het configuratiebestand voordat je de container opnieuw aanmaakt. Een installatie onder `/tmp` kan hier tegenaan lopen nadat macOS tijdelijke bestanden heeft verwijderd.

### Conflicten met poorten of containernamen

Als poort `8080` in gebruik is, kies dan een andere poort in `config/overleaf.rc`, stel `OVERLEAF_SITE_URL` daarop af en voer `bin/up -d` opnieuw uit.

De Toolkit geeft zijn containers vaste namen zoals `sharelatex`, `mongo` en `redis`. Alleen `PROJECT_NAME` wijzigen maakt twee Toolkit-installaties niet onafhankelijk. Controleer `docker ps -a` voordat je een tweede instantie start, en gebruik andere containernamen in een Compose-override, een andere poort en aparte gegevensmappen. Verwijder geen containers of gegevens van een bestaande deployment om een naamconflict op te lossen.

### De instantie is na een tijdje onbereikbaar

De Mac is waarschijnlijk in slaap gevallen, of Docker Desktop is afgesloten. Zie [De instantie beschikbaar houden](https://ayakaleaf-pro.mintlify.site/nl/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md#keep-the-instance-available).

### `bin/doctor` meldt dat dit geen Linux is, of vraagt om een Quay-login

Beide waarschuwingen zijn te verwachten op macOS met de openbare image; zie [2. Maak kennis met de Toolkit](https://ayakaleaf-pro.mintlify.site/nl/on-premises/installation/using-docker-compose/macos/2.-familiarize-yourself-with-the-toolkit.md). Controleer in plaats daarvan het ophalen van de images, de status van de services en de compilatieresultaten, en negeer geen andere fouten in het rapport.


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