5. Uw instantie personaliseren

​

Uw instantie personaliseren

Werk twee configuratiebestanden bij met uw eigen gegevens voordat u uw Overleaf-instantie voor de eerste keer start:

Bestand	Gelezen door	Wat u hier instelt
config/overleaf.rc	de Toolkit-scripts, zoals bin/up	hoe containers draaien: OVERLEAF_LISTEN_IP, OVERLEAF_PORT, SERVER_PRO, datapaden
config/variables.env	de applicatie in de container	hoe Overleaf zich gedraagt: OVERLEAF_SITE_URL, e-mail, TeX Live-images

1. Het variabelenbestand bewerken

   Open config/variables.env in uw favoriete teksteditor en werk de onderstaande omgevingsvariabelen bij met de vereiste waarden.

2. Luisteradres en poort

   Standaard publiceert de Toolkit de webinterface op 127.0.0.1:80, zodat deze alleen kan worden geopend vanuit een browser op de server zelf. Andere computers krijgen een foutmelding als “connection refused” of “server not found”. Om dit te wijzigen, bewerkt u config/overleaf.rc:

   config/overleaf.rc

   OVERLEAF_LISTEN_IP=0.0.0.0
   OVERLEAF_PORT=8080
   

   OVERLEAF_LISTEN_IP is het IP-adres van de host waaraan de container wordt gekoppeld, en OVERLEAF_PORT is de poort op de host. Samen vormen ze de Docker-poorttoewijzing OVERLEAF_LISTEN_IP:OVERLEAF_PORT:80. Kies de waarden die bij uw situatie passen:

   Situatie	OVERLEAF_LISTEN_IP	OVERLEAF_PORT	Openen in browser
   Alleen op deze machine (standaard)	127.0.0.1	80	http://localhost
   Andere computers in het LAN of op internet maken rechtstreeks verbinding	0.0.0.0, of één IP-adres van de server	80, of een willekeurige vrije poort	http://<server-ip>:<port>
   Achter uw eigen reverse proxy (NGINX, Caddy, Cloudflare Tunnel) op dezelfde host	127.0.0.1	een willekeurige vrije poort	de URL van de proxy
   Achter de TLS-proxy van de Toolkit	127.0.0.1	80	https://<your-domain>

   Als poort 80 op de host al in gebruik is, bijvoorbeeld door een andere webserver, stel OVERLEAF_PORT dan in op een vrije poort zoals 8080. Anders mislukt bin/up met bind: address already in use.

   Poorten die door Docker worden gepubliceerd, omzeilen hostfirewalls zoals ufw en firewalld. Met 0.0.0.0 is de instantie bereikbaar vanuit elk netwerk waarmee de server is verbonden. Op een cloudserver moet u de poort ook toestaan in de security group van de provider. Gebruik HTTPS voordat u de instantie openstelt voor internet, zie TLS-proxy.

   U kunt beginnen met de standaardwaarde en de instantie eerst op localhost openen. Om later toegang vanaf andere computers toe te staan, wijzigt u deze twee variabelen in config/overleaf.rc en OVERLEAF_SITE_URL in config/variables.env, en voert u daarna bin/up opnieuw uit om de containers opnieuw aan te maken.

3. Vereiste omgevingsvariabelen

   Werk de volgende variabelen bij in config/variables.env:

   Naam	Beschrijving	Voorbeeld
   OVERLEAF_SITE_URL	Waar uw Overleaf-instantie publiek beschikbaar is. Dit wordt gebruikt in openbare links en bij het verbinden via websockets, dus het moet correct zijn geconfigureerd!	https://overleaf.lilliput.com
   OVERLEAF_EMAIL_FROM_ADDRESS	Dit e-mailadres wordt gebruikt als from-adres voor alle uitgaande e-mails.	[e-mail]
   OVERLEAF_ADMIN_EMAIL	Het e-mailadres waarop gebruikers de beheerder van de site kunnen bereiken.	[e-mail]

   OVERLEAF_SITE_URL is het adres dat gebruikers in hun browser typen, niet het luisteradres. Neem de poort op als deze niet 80 (HTTP) of 443 (HTTPS) is, bijvoorbeeld http://192.168.1.20:8080. Gebruik geen http://0.0.0.0. Als OVERLEAF_SITE_URL niet overeenkomt met het adres in de browser, kan de editor geen verbinding maken en verwijzen links in e-mails en OAuth-callbacks naar de verkeerde plek.

   Laat zonder mailserver OVERLEAF_EMAIL_FROM_ADDRESS leeg: Overleaf verstuurt dan geen e-mails, en je kunt nieuwe gebruikers zelf hun activatielink geven; zie de Vragen en antwoorden in Openbare toegang.

   Stel ook OVERLEAF_SESSION_SECRET in op een waarde die is gegenereerd met openssl rand -hex 32. Zonder deze variabele logt elke bin/up die de container opnieuw aanmaakt, en elke upgrade, alle gebruikers uit. Zie de Vragen en antwoorden in Omgevingsvariabelen.

   Sla het bestand op en sluit het af zodra u deze omgevingsvariabelen hebt bijgewerkt.

4. Sandbox-compilatie instellen

   Configureer vervolgens TeX Live Full voor sandboxed-compiles.md. Open config/variables.env en werk de volgende omgevingsvariabelen bij:

   config/variables.env

   ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
   ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
   TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
   
5. Uw instantie starten

   Voer het volgende uit om uw instantie te starten:

   Start the instance

   bin/up
   

   Deze opdracht downloadt de benodigde images, inclusief texlive, maakt de containers aan (met uw aanpassingen) en start de instantie. U zou loguitvoer van de verschillende Docker-containers moeten zien.

   Om ze later opnieuw te starten (zonder aan de loguitvoer te koppelen), voert u het volgende uit:

   Start without attaching to logs

   bin/start
   

De Toolkit gebruikt docker compose om de Docker-containers van Overleaf te beheren. De Toolkit biedt een set scripts die docker compose omhullen en de meeste details voor u regelen.

Als alles goed gaat, zou u de inlogpagina van uw nieuwe Overleaf-instantie moeten kunnen zien door in uw browser naar http://127.0.0.1/ of http://localhost/ te gaan. Als u OVERLEAF_LISTEN_IP of OVERLEAF_PORT hebt gewijzigd, opent u in plaats daarvan het adres uit de tabel in de stap Luisteradres en poort, bijvoorbeeld http://<server-ip>:8080.

Om te controleren op welk adres en welke poort de webinterface wordt gepubliceerd, voert u het volgende uit:

Show the published port

bin/docker-compose port sharelatex 80

De uitvoer, bijvoorbeeld 0.0.0.0:8080, toont het IP-adres en de poort van de host die in gebruik zijn. Als 127.0.0.1 wordt getoond, is de instantie alleen bereikbaar vanaf de server zelf.

Afhankelijk van uw netwerkconfiguratie en de plek waar uw Overleaf-instantie wordt gehost, moet u mogelijk aanvullende configuratiewijzigingen doorvoeren. Zie de Toolkit-instellingen voor meer details: toolkit-settings.md