Omgevingsvariabelen

Deze pagina beschrijft de omgevingsvariabelen die worden ondersteund in het bestand config/variables.env voor Toolkit-deployments.

Het bestand config/variables.env bestaat uit variabeledefinities in de vorm NAME=value; regels die beginnen met # worden als commentaar behandeld.

Na elke wijziging in overleaf.rc of variables.env moet je de Docker-containers opnieuw aanmaken door bin/up uit te voeren.

​

Alle versies

Deze omgevingsvariabelen zijn compatibel met Server CE en Server Pro en bieden een eenvoudig migratiepad tussen deze twee on-premise versies. Ze kunnen ook worden gebruikt bij zowel Toolkit- als Docker Compose-deployments.

Voorheen hadden deze omgevingsvariabelen het voorvoegsel SHARELATEX_ in plaats van OVERLEAF_.

Naam	Beschrijving
OVERLEAF_SITE_URL	Het adres waarop je Overleaf-instantie publiek beschikbaar is. Dit wordt gebruikt in publieke links en bij het verbinden via websockets, dus moet correct worden geconfigureerd!
OVERLEAF_ADMIN_EMAIL	Het e-mailadres waarop gebruikers de beheerder van de site kunnen bereiken.
OVERLEAF_APP_NAME	De naam die wordt weergegeven wanneer naar de draaiende applicatie wordt verwezen. Standaard ‘Overleaf (Community Edition)’.
OVERLEAF_MONGO_URL en MONGO_URL	De URL van de te gebruiken Mongo-database.
OVERLEAF_REDIS_HOST en REDIS_HOST	De hostnaam van de te gebruiken Redis-instantie. Beide zijn verplicht (zie de release notes).
OVERLEAF_REDIS_PORT en REDIS_PORT	De poort van de te gebruiken Redis-instantie. Beide zijn verplicht (zie de release notes).
OVERLEAF_REDIS_PASS en REDIS_PASSWORD	Het wachtwoord om mee te verbinden met Redis (indien van toepassing). Beide omgevingsvariabelen moeten worden ingesteld. Zie wachtwoordauthenticatie inschakelen voor meer informatie.
OVERLEAF_REDIS_TLS	Indien ingesteld op true, is verbinding mogelijk met een Redis-instantie die TLS vereist. Let op: mTLS wordt momenteel niet ondersteund.
OVERLEAF_NAV_TITLE	Stelt de tabbladtitel van de applicatie in.
OVERLEAF_HEADER_IMAGE_URL_LIGHT en OVERLEAF_HEADER_IMAGE_URL_DARK	URL’s van aangepaste headerlogo’s voor het lichte en het donkere thema (toegevoegd in 6.3.0). Elk thema valt terug op OVERLEAF_HEADER_IMAGE_URL wanneer de specifieke variabele niet is ingesteld. Zie Branding.
OVERLEAF_LINKED_URL_OUTBOUND_PROXY	URL van een HTTP(S)-proxy voor het ophalen van externe gekoppelde bestanden en externe ZIP- of TeX-resources via de Open in Overleaf-API. Beschikbaar vanaf de opnieuw uitgebrachte Ayakaleaf Pro 6.3.0 (3 oktober 2026). Laat leeg om rechtstreeks te verbinden. Voorbeeld: OVERLEAF_LINKED_URL_OUTBOUND_PROXY=http://proxy.internal:3128. Zie Outbound Proxy voor configuratie en beperkingen van netwerktoegang.
OVERLEAF_INVITE_TOKEN_SECRET	Verplicht. Een willekeurige string die wordt gebruikt om tokens voor het delen van projecten te beveiligen (toegevoegd in Server Pro 6.2.0). Minimumaantal tekens: 16
OVERLEAF_SESSION_SECRET	Een willekeurige string die wordt gebruikt om tokens te beveiligen; bij load balancing moet deze op alle machines op dezelfde waarde worden ingesteld. Als er maar 1 instantie draait, hoeft de gebruiker deze niet in te stellen.
OVERLEAF_COOKIE_SESSION_LENGTH	Hiermee kun je de standaard verlooptijd van 5 dagen van de sessiecookie overschrijven. De waarde moet in milliseconden worden opgegeven. Voorbeeld: om de sessie 1 uur te laten duren, stel je COOKIE_SESSION_LENGTH=3600000 in. (Toegevoegd in Server Pro 4.2)
OVERLEAF_TRUSTED_PROXY_IPS	Indien niet ingesteld, is de standaardwaarde loopback. Als je deze handmatig instelt, moet je naast je vertrouwde IP-adressen ook loopback (of 127.0.0.1) opnemen, waarmee de nginx-instantie binnen de sharelatex-container wordt vertrouwd. Alleen IP-adressen en CIDR-bereiken worden geaccepteerd: voeg geen hostnamen zoals localhost toe, anders start Overleaf niet en krijg je 502 Bad Gateway. Als je voor je gewone netwerk een subnet uit 172.16.0.0/12 gebruikt (het standaardsubnet voor Docker-netwerken), stel dan OVERLEAF_TRUSTED_PROXY_IPS=loopback,<network> in je config/variables.env in. Hierbij is <network> de waarde IPAM -> Config -> Subnet uit docker inspect overleaf_default, bijv. OVERLEAF_TRUSTED_PROXY_IPS=loopback,172.19.0.0/16. Dit voorkomt het vervalsen van X-Forwarded-headers. Als je een externe TLS-proxy gebruikt (d.w.z. een die niet door de Overleaf Toolkit wordt beheerd), zorg dan voor OVERLEAF_TRUSTED_PROXY_IPS=loopback,<ip-of-your-tls-proxy>, bijv. OVERLEAF_TRUSTED_PROXY_IPS=loopback,192.168.13.37.
OVERLEAF_RESTRICT_INVITES_TO_EXISTING_ACCOUNTS	Indien ingesteld op true, worden projectuitnodigingen beperkt tot e-mailadressen die bij bestaande gebruikersaccounts horen.
OVERLEAF_ALLOW_PUBLIC_ACCESS	Indien ingesteld op true, kunnen niet-geauthenticeerde gebruikers de site bekijken. De standaardwaarde is false, wat betekent dat niet-geauthenticeerde gebruikers onvoorwaardelijk naar de inlogpagina worden doorgestuurd wanneer ze een deel van de site proberen te bekijken. Let op: deze optie schakelt authenticatie of beveiliging op geen enkele manier uit. Deze optie is nodig als je gebruikers hun projecten openbaar willen maken en niet-geauthenticeerde gebruikers die projecten willen laten bekijken.
OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING	Indien ingesteld op true, kunnen anonieme gebruikers projecten bekijken en bewerken die via de functie link-sharing zijn gedeeld.
OVERLEAF_DISABLE_LINK_SHARING	Schakelt de functie link-sharing uit.
EMAIL_CONFIRMATION_DISABLED	Indien ingesteld op true, wordt de banner met het verzoek om het e-mailadres te bevestigen niet weergegeven.
ADDITIONAL_TEXT_EXTENSIONS	Een array van strings om extra extensies voor bewerkbare bestanden te configureren.
DEFAULT_LATEX_COMPILER	Hiermee stel je de standaardcompiler in voor nieuwe projecten. (Toegevoegd in Server Pro 6.2.0). Opties: pdflatex, latex, xelatex of lualatex
OVERLEAF_STATUS_PAGE_URL	Aangepaste URL voor de statuspagina (toegevoegd in Server Pro 3.4.0), bijv. status.example.com.
OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS	Stel in op 'false' om te voorkomen dat nieuwe projecten worden geïnitialiseerd met Full Project History (toegevoegd in Server Pro 3.5.0).
OVERLEAF_FPH_DISPLAY_NEW_PROJECTS	Stel in op 'false' om te voorkomen dat nieuwe projecten Full Project History weergeven in plaats van de verouderde geschiedenis (toegevoegd in Server Pro 3.5.0).
ENABLE_CRON_RESOURCE_DELETION	Stel deze omgevingsvariabele in op true om verwijderde projecten en gebruikers na 90 dagen automatisch op te ruimen.
OVERLEAF_USER_HARD_DELETION_DELAY	Hiermee pas je de verloopvertraging voor verwijderde gebruikers aan. Ingesteld in milliseconden. Standaard: 90 dagen
OVERLEAF_PROJECT_HARD_DELETION_DELAY	Hiermee pas je de verloopvertraging voor verwijderde projecten aan. Ingesteld in milliseconden. Standaard: 90 dagen
MAX_UPLOAD_SIZE	Bepaalt de maximale grootte van een afzonderlijke upload, in megabytes. Standaard 50. Let op: Deze variabele is slechts een kaal getal, zonder eenheid (MB) of omhulling. De totale ongecomprimeerde grootte van een geüpload .zip-bestand is beperkt tot 6 × deze waarde (standaard 300 MB).
COMPILE_SIZE_LIMIT	Bepaalt de maximale grootte van de request body in bytes. Dit is de som van alle doc-bestandsgroottes binnen het project (main.tex, references.bib (indien niet gekoppeld), enz.) die in het eerste compileerverzoek naar de CLSI-service moeten worden gestuurd.
COMPILE_TIMEOUT	De tijd in seconden die een compilatie mag duren. Zie De compileertime-out van een project bijwerken voor meer informatie.
MAX_RECONNECT_GRACEFULLY_INTERVAL_MS	Een configureerbare vertraging tussen het netjes opnieuw verbinden van de editor, het wegschrijven van gegevens en het afsluiten van de container, om het risico op gegevensverlies te beperken.
SECCOMP_PROFILE	Stel deze omgevingsvariabele in op een pad op de Docker-hostmachine dat naar het SECCOMP-profiel verwijst. Je kunt hier een kopie van het profiel downloaden. Momenteel nodig voor Podman-deployments bij gebruik van Sandboxed Compiles.
OVERLEAF_DISABLE_CHAT	Indien ingesteld op true, wordt de chatfunctie binnen projecten uitgeschakeld.
OVERLEAF_LOGIN_SUPPORT_TEXT	Indien ingesteld, kan hiermee ondersteuningsinformatie onder de inlogknop worden weergegeven. De tekst wordt op het inlogscherm getoond en kan worden gebruikt om gebruikers door te verwijzen naar interne ondersteuning of om uitleg te geven over inloggen, accounts aanmaken, enz.
ALLOW_MONGO_ADMIN_CHECK_FAILURES	Indien ingesteld op true, mogen de opstartcontroles van MongoDB mislukken zonder dat dit het starten van de deployment verhindert. Dit kan nodig zijn als je een MongoDB-database gebruikt waarin je databasegebruiker niet de rol clusterParameterReader heeft. Hulp bij het aanmaken van een aangepaste rol vind je hier.
V1_HISTORY_URL_FOR_GIT_BRIDGE	Maakt het mogelijk het history-v1-endpoint te scheiden voor intern verkeer (web-service → history-v1-service, beide in de sharelatex-container) en extern verkeer (git-bridge → history-v1, draaiend in aparte containers).
OVERLEAF_MAINTENANCE_MESSAGE en OVERLEAF_MAINTENANCE_MESSAGE_HTML	Wordt gebruikt om de titel en inhoud van de onderhoudspagina aan te passen. Kan niet samen met OVERLEAF_STATUS_PAGE_URL worden gebruikt.

Het is mogelijk om wachtwoordeisen aan gebruikers op te leggen wanneer het Overleaf-inlogsysteem (lokale accounts) wordt gebruikt, en geen SSO-optie zoals LDAP. Voor SSO-accounts worden wachtwoordbeleidsregels afgedwongen door je identiteitsprovider of directoryservice, die daarnaast ondersteuning voor meervoudige authenticatie kan bieden.