Miljøvariabler

Denne side beskriver de miljøvariabler, der understøttes i filen config/variables.env ved Toolkit-udrulninger.

Filen config/variables.env består af variabeldefinitioner på formen NAME=value; linjer, der begynder med #, behandles som kommentarer.

Det er nødvendigt at genskabe Docker-containerne ved at køre bin/up, når du har ændret noget i overleaf.rc eller variables.env.

​

Alle versioner

Disse miljøvariabler er kompatible med Server CE og Server Pro og giver en nem migreringsvej mellem disse to on-premises-versioner. De kan også bruges med både Toolkit- og Docker Compose-udrulninger.

Tidligere havde disse miljøvariabler præfikset SHARELATEX_ i stedet for OVERLEAF_.

Navn	Beskrivelse
OVERLEAF_SITE_URL	Den adresse, hvor din Overleaf-instans er offentligt tilgængelig. Den bruges i offentlige links og ved forbindelser via websockets, så den skal være korrekt konfigureret!
OVERLEAF_ADMIN_EMAIL	Den e-mailadresse, hvor brugerne kan kontakte den person, der driver webstedet.
OVERLEAF_APP_NAME	Det navn, der vises, når der henvises til den kørende applikation. Standardværdien er ‘Overleaf (Community Edition)’.
OVERLEAF_MONGO_URL og MONGO_URL	URL’en til den Mongo-database, der skal bruges.
OVERLEAF_REDIS_HOST og REDIS_HOST	Værtsnavnet på den Redis-instans, der skal bruges. Begge er påkrævet (se udgivelsesnoter).
OVERLEAF_REDIS_PORT og REDIS_PORT	Porten på den Redis-instans, der skal bruges. Begge er påkrævet (se udgivelsesnoter).
OVERLEAF_REDIS_PASS og REDIS_PASSWORD	Den adgangskode, der skal bruges ved forbindelse til Redis (hvis relevant). Begge miljøvariabler skal være sat. Se aktivering af adgangskodegodkendelse for flere oplysninger.
OVERLEAF_REDIS_TLS	Hvis den er sat til true, tillades forbindelse til en Redis-instans, der kræver TLS. Bemærk: mTLS understøttes i øjeblikket ikke.
OVERLEAF_NAV_TITLE	Angiver applikationens fanetitel.
OVERLEAF_HEADER_IMAGE_URL_LIGHT og OVERLEAF_HEADER_IMAGE_URL_DARK	URL’er til brugerdefinerede headerlogoer til det lyse og det mørke tema (tilføjet i 6.3.0). Hvert tema falder tilbage til OVERLEAF_HEADER_IMAGE_URL, når dets specifikke variabel ikke er sat. Se Branding.
OVERLEAF_LINKED_URL_OUTBOUND_PROXY	URL’en til en HTTP(S)-proxy til hentning af eksterne linkede filer og eksterne ZIP- eller TeX-ressourcer via Open in Overleaf-API’et. Tilgængelig fra og med den genudgivne Ayakaleaf Pro 6.3.0 (3. oktober 2026). Lad den være usat for at oprette forbindelse direkte. Eksempel: OVERLEAF_LINKED_URL_OUTBOUND_PROXY=http://proxy.internal:3128. Se Udgående proxy for konfiguration og begrænsninger af netværksadgang.
OVERLEAF_INVITE_TOKEN_SECRET	Påkrævet. En tilfældig streng, der bruges til at sikre tokens til projektdeling (tilføjet i Server Pro 6.2.0). Mindste antal tegn: 16
OVERLEAF_SESSION_SECRET	En tilfældig streng, der bruges til at sikre tokens; ved load balancing skal den sættes til det samme token på tværs af maskinerne. Hvis der kun køres én instans, behøver brugeren ikke at sætte den.
OVERLEAF_COOKIE_SESSION_LENGTH	Giver dig mulighed for at tilsidesætte standardudløbstiden for sessionscookien på 5 dage. Værdien skal angives i millisekunder. Eksempel: For at lade sessionen vare 1 time skal du sætte COOKIE_SESSION_LENGTH=3600000. (Tilføjet i Server Pro 4.2)
OVERLEAF_TRUSTED_PROXY_IPS	Hvis den ikke er sat, er standardværdien loopback. Hvis du sætter den manuelt, skal du ud over dine betroede IP-adresser også inkludere loopback (eller 127.0.0.1), som giver tillid til den nginx-instans, der kører inde i sharelatex-containeren. Kun IP-adresser og CIDR-intervaller accepteres: tilføj ikke værtsnavne som localhost, da Overleaf ellers ikke starter og returnerer 502 Bad Gateway. Hvis du bruger et subnet fra 172.16.0.0/12 (standardsubnettet for Docker-netværk) til dit almindelige netværk, skal du sætte OVERLEAF_TRUSTED_PROXY_IPS=loopback,<network> i din config/variables.env, hvor <network> er værdien IPAM -> Config -> Subnet i docker inspect overleaf_default, f.eks. OVERLEAF_TRUSTED_PROXY_IPS=loopback,172.19.0.0/16. Dette skal forhindre forfalskning af X-Forwarded-headers. Hvis du bruger en ekstern TLS-proxy (dvs. en, der ikke administreres af Overleaf Toolkit), skal du sikre, at OVERLEAF_TRUSTED_PROXY_IPS=loopback,<ip-of-your-tls-proxy> er sat, f.eks. OVERLEAF_TRUSTED_PROXY_IPS=loopback,192.168.13.37.
OVERLEAF_RESTRICT_INVITES_TO_EXISTING_ACCOUNTS	Hvis den er sat til true, begrænses projektinvitationer til e-mailadresser, der svarer til eksisterende brugerkonti.
OVERLEAF_ALLOW_PUBLIC_ACCESS	Hvis den er sat til true, kan ikke-godkendte brugere se webstedet. Standardværdien er false, hvilket betyder, at ikke-godkendte brugere ubetinget omdirigeres til loginsiden, når de forsøger at se en hvilken som helst del af webstedet. Bemærk, at denne indstilling på ingen måde deaktiverer godkendelse eller sikkerhed. Indstillingen er nødvendig, hvis dine brugere ønsker at gøre deres projekter offentlige og lade ikke-godkendte brugere se dem.
OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING	Hvis den er sat til true, kan anonyme brugere se og redigere projekter, der er delt via funktionen linkdeling.
OVERLEAF_DISABLE_LINK_SHARING	Deaktiverer funktionen linkdeling.
EMAIL_CONFIRMATION_DISABLED	Når den er sat til true, vises banneret, der beder om bekræftelse af e-mail, ikke.
ADDITIONAL_TEXT_EXTENSIONS	Et array af strenge til konfiguration af yderligere filtypenavne for redigerbare filer.
DEFAULT_LATEX_COMPILER	Bruges til at angive den standardkompiler, der bruges af nye projekter. (Tilføjet i Server Pro 6.2.0). Muligheder: pdflatex, latex, xelatex eller lualatex
OVERLEAF_STATUS_PAGE_URL	URL til en brugerdefineret statusside (tilføjet i Server Pro 3.4.0), f.eks. status.example.com.
OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS	Sæt til 'false' for at forhindre, at nye projekter initialiseres med Full Project History (tilføjet i Server Pro 3.5.0).
OVERLEAF_FPH_DISPLAY_NEW_PROJECTS	Sæt til 'false' for at forhindre, at nye projekter viser Full Project History i stedet for den ældre historik (tilføjet i Server Pro 3.5.0).
ENABLE_CRON_RESOURCE_DELETION	Sæt denne miljøvariabel til true for at aktivere automatisk oprydning af slettede projekter og brugere efter 90 dage.
OVERLEAF_USER_HARD_DELETION_DELAY	Bruges til at ændre udløbsforsinkelsen for slettede brugere. Angives i millisekunder. Standard: 90 dage
OVERLEAF_PROJECT_HARD_DELETION_DELAY	Bruges til at ændre udløbsforsinkelsen for slettede projekter. Angives i millisekunder. Standard: 90 dage
MAX_UPLOAD_SIZE	Styrer den maksimale størrelse på en enkelt upload i megabyte. Standardværdien er 50. Bemærk: Denne variabel er blot et rent tal uden enhed (MB) eller omslutning. Den samlede ukomprimerede størrelse af en uploadet .zip-fil er begrænset til 6 × denne værdi (300 MB som standard).
COMPILE_SIZE_LIMIT	Styrer den maksimale størrelse på forespørgslens body i byte. Dette er summen af størrelserne på alle dokumentfiler i projektet (main.tex, references.bib (hvis den ikke er linket) osv.), som skal sendes i den indledende kompileringsforespørgsel til CLSI-tjenesten.
COMPILE_TIMEOUT	Den tid i sekunder, en kompilering har til at blive færdig. Se Opdatering af projektets kompileringstimeout for flere oplysninger.
MAX_RECONNECT_GRACEFULLY_INTERVAL_MS	En konfigurerbar forsinkelse mellem editorens kontrollerede genforbindelse, tømning af data og nedlukning af containeren for at mindske risikoen for datatab.
SECCOMP_PROFILE	Sæt denne miljøvariabel til en sti på Docker-værtsmaskinen, der peger på SECCOMP-profilen. Du kan downloade en kopi af profilen her. Er i øjeblikket nødvendig ved Podman-udrulninger, når der bruges Sandboxed Compiles.
OVERLEAF_DISABLE_CHAT	Hvis den er sat til true, deaktiveres chatfunktionen i projekter.
OVERLEAF_LOGIN_SUPPORT_TEXT	Når den er sat, kan den bruges til at vise supportoplysninger under login-knappen. Teksten vises på loginskærmen og kan bruges til at henvise brugere til intern support eller give vejledning om login, oprettelse af konti osv.
ALLOW_MONGO_ADMIN_CHECK_FAILURES	Hvis den er sat til true, kan MongoDB-opstartskontrollerne fejle uden at forhindre udrulningen i at starte. Dette kan være nødvendigt, hvis du bruger en MongoDB-database, hvor din databasebruger ikke har rollen clusterParameterReader. Se her for hjælp til at oprette en brugerdefineret rolle.
V1_HISTORY_URL_FOR_GIT_BRIDGE	Gør det muligt at adskille history-v1-endpointet for intern trafik (web-tjenesten → history-v1-tjenesten, begge i sharelatex-containeren) og ekstern trafik (git-bridge → history-v1, der kører i separate containere).
OVERLEAF_MAINTENANCE_MESSAGE og OVERLEAF_MAINTENANCE_MESSAGE_HTML	Bruges til at tilpasse titlen og indholdet på vedligeholdelsessiden. Kan ikke bruges sammen med OVERLEAF_STATUS_PAGE_URL.

Det er muligt at håndhæve adgangskodekrav for brugere, når der bruges Overleafs loginsystem (lokale konti) og ikke en SSO-løsning som LDAP. For SSO-konti håndhæves adgangskodepolitikker af din identitetsudbyder eller katalogtjeneste, som desuden kan understøtte multifaktorgodkendelse.