5. Anpassa din instans

Ange port, webbplats-URL och TeX Live-avbildning för en lokal instans på din Mac, kontrollera Docker-VM:ens kärna och starta Ayakaleaf Pro.

1. Containerinställningar

   Redigera dessa befintliga poster i 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
   

   Behåll standardsökvägarna för data och de medföljande tjänsterna MongoDB och Redis. Med OVERLEAF_LISTEN_IP=127.0.0.1 kan endast webbläsare på den här Macen öppna instansen.

2. Applikationsinställningar

   I config/variables.env anger du dessa värden och ersätter eventuella aktiva poster med samma namn:

   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"
   

   Generera en sessionshemlighet:

   openssl rand -hex 32
   

   Lägg till resultatet som OVERLEAF_SESSION_SECRET i config/variables.env. Utan den loggas alla användare ut vid varje bin/up som återskapar containern, se Miljövariabler.

   För en lokal instans utan e-post lämnar du SMTP-inställningarna och OVERLEAF_EMAIL_FROM_ADDRESS oinställda. Git Bridge, extern autentisering och de andra integrationerna kan läggas till senare med sina egna konfigurationssidor.

3. Kontrollera Linux-kärnan i Docker-VM:en

   MongoDB körs på Linux-kärnan i Docker Desktops virtuella maskin, inte på macOS. Kontrollera dess version före den första starten:

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

   MongoDB dokumenterar en inkompatibilitet med Linux-kärnor 6.19 till och med 7.0.13, som även påverkar MongoDB i Docker. Lösningen är en kärna 7.0.14 eller senare, som följer med en uppdatering av Docker Desktop, se MongoDB:s produktionsanteckningar.

   Om din Docker-VM använder en påverkad kärna lägger du till följande i config/docker-compose.override.yml, sammanslaget med eventuella services som du redan har där:

   config/docker-compose.override.yml

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

   Uppdatera till en åtgärdad kärna när en sådan finns tillgänglig. Om din kärna ligger utanför det påverkade intervallet behövs inte den här lösningen.

4. Starta din instans

   Kör följande från Toolkit-katalogen:

   bin/up -d
   

   Toolkit initierar MongoDB:s replikuppsättning, hämtar TeX Live-avbildningen och startar applikationen. Den första nedladdningen tar en stund. Så här följer du förloppet:

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

   Tryck på Ctrl+C för att sluta följa loggarna. Containrarna fortsätter att köras.

   Kontrollera den publicerade porten och sidan för första körningen:

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

   Porten ska vara 127.0.0.1:8080.

För att senare öppna instansen från andra datorer ändrar du lyssningsadressen och webbplats-URL:en och konfigurerar HTTPS, enligt beskrivningen i 5. Anpassa din instans i Linux-guiden. Din Mac måste då förbli vaken, se Håll instansen tillgänglig.

​

Nästa steg

Fortsätt med 6. Uppgifter efter installationen.