5. Je instantie personaliseren

Stel de poort, site-URL en TeX Live-image in voor een lokale instantie op je Mac, controleer de kernel van de Docker-VM en start Ayakaleaf Pro.

1. Containerinstellingen

   Bewerk deze bestaande regels in config/overleaf.rc:

   config/overleaf.rc

   PROJECT_NAME=ayakaleaf-macos
   SERVER_PRO=true
   OVERLEAF_LISTEN_IP=127.0.0.1
   OVERLEAF_PORT=8080
   SIBLING_CONTAINERS_ENABLED=true
   DOCKER_SOCKET_PATH=/var/run/docker.sock
   

   Behoud de standaard gegevenspaden en de meegeleverde MongoDB- en Redis-services. Met OVERLEAF_LISTEN_IP=127.0.0.1 kunnen alleen browsers op deze Mac de instantie openen.

2. Applicatie-instellingen

   Stel in config/variables.env deze waarden in en vervang eventuele actieve regels met dezelfde namen:

   config/variables.env

   OVERLEAF_SITE_URL=http://localhost:8080
   TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
   ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1
   ALL_TEX_LIVE_DOCKER_IMAGE_NAMES="TeX Live 2026"
   

   Genereer een sessiegeheim:

   openssl rand -hex 32
   

   Voeg het resultaat toe als OVERLEAF_SESSION_SECRET in config/variables.env. Zonder dit geheim worden bij elke bin/up die de container opnieuw aanmaakt alle gebruikers uitgelogd; zie Omgevingsvariabelen.

   Laat voor een lokale instantie zonder e-mail de SMTP-instellingen en OVERLEAF_EMAIL_FROM_ADDRESS leeg. Git Bridge, externe authenticatie en de andere integraties kun je later toevoegen met hun eigen configuratiepagina’s.

3. De Linux-kernel van de Docker-VM controleren

   MongoDB draait op de Linux-kernel van de virtuele machine van Docker Desktop, niet op macOS. Controleer de versie ervan vóór de eerste start:

   docker info --format '{{.KernelVersion}}'
   

   MongoDB documenteert een incompatibiliteit met Linux-kernels 6.19 tot en met 7.0.13, die ook MongoDB in Docker treft. De oplossing is een kernel 7.0.14 of hoger, die met een update van Docker Desktop wordt geleverd; zie de productienotities van MongoDB.

   Als je Docker-VM een getroffen kernel gebruikt, voeg dan het volgende toe aan config/docker-compose.override.yml, samengevoegd met eventuele services die je daar al hebt:

   config/docker-compose.override.yml

   services:
     mongo:
       environment:
         GLIBC_TUNABLES: glibc.pthread.rseq=1
   

   Werk bij naar een gerepareerde kernel zodra die beschikbaar is. Als je kernel buiten het getroffen bereik valt, is deze workaround niet nodig.

4. Je instantie starten

   Voer vanuit de Toolkit-map het volgende uit:

   bin/up -d
   

   De Toolkit initialiseert de replica set van MongoDB, haalt de TeX Live-image op en start de applicatie. De eerste download duurt even. Om de voortgang te volgen:

   bin/docker-compose ps
   bin/docker-compose logs --tail=100 -f sharelatex
   

   Druk op Ctrl+C om te stoppen met het volgen van de logs. De containers blijven draaien.

   Controleer de gepubliceerde poort en de pagina voor de eerste start:

   bin/docker-compose port sharelatex 80
   curl -I http://localhost:8080/launchpad
   

   De poort moet 127.0.0.1:8080 zijn.

Om de instantie later vanaf andere computers te openen, wijzig je het luisteradres en de site-URL en stel je HTTPS in, zoals beschreven in 5. Uw instantie personaliseren van de Linux-handleiding. De Mac moet dan wakker blijven; zie De instantie beschikbaar houden.

​

Volgende stap

Ga verder met 6. Taken na de installatie.