5. Tilpasning af din instans

​

Tilpasning af din instans

Før du starter din Overleaf-instans første gang, skal du opdatere to konfigurationsfiler med dine egne oplysninger:

Fil	Læses af	Angives her
config/overleaf.rc	Toolkit-scriptsene, såsom bin/up	hvordan containerne kører: OVERLEAF_LISTEN_IP, OVERLEAF_PORT, SERVER_PRO, datastier
config/variables.env	applikationen inde i containeren	hvordan Overleaf opfører sig: OVERLEAF_SITE_URL, e-mail, TeX Live-images

1. Rediger variabelfilen

   Åbn config/variables.env i din foretrukne teksteditor, og opdater miljøvariablerne nedenfor med de påkrævede værdier.

2. Lytteadresse og port

   Som standard udstiller Toolkit webgrænsefladen på 127.0.0.1:80, så den kun kan åbnes fra en browser på selve serveren. Andre computere får fejlen “connection refused” eller “server not found”. For at ændre dette skal du redigere config/overleaf.rc:

   config/overleaf.rc

   OVERLEAF_LISTEN_IP=0.0.0.0
   OVERLEAF_PORT=8080
   

   OVERLEAF_LISTEN_IP er den IP-adresse på værten, som containeren binder til, og OVERLEAF_PORT er porten på værten. Sammen udgør de Docker-porttilknytningen OVERLEAF_LISTEN_IP:OVERLEAF_PORT:80. Vælg de værdier, der passer til din opsætning:

   Opsætning	OVERLEAF_LISTEN_IP	OVERLEAF_PORT	Åbn i browser
   Kun på denne maskine (standard)	127.0.0.1	80	http://localhost
   Andre computere på LAN eller internettet forbinder direkte	0.0.0.0 eller en af serverens IP’er	80 eller en vilkårlig ledig port	http://<server-ip>:<port>
   Bag din egen reverse proxy (NGINX, Caddy, Cloudflare Tunnel) på samme vært	127.0.0.1	en vilkårlig ledig port	proxyens URL
   Bag Toolkits TLS-proxy	127.0.0.1	80	https://<your-domain>

   Hvis port 80 allerede er i brug på værten, for eksempel af en anden webserver, skal du sætte OVERLEAF_PORT til en ledig port såsom 8080. Ellers mislykkes bin/up med bind: address already in use.

   Porte, der udstilles af Docker, omgår værtens firewalls såsom ufw og firewalld. Med 0.0.0.0 kan instansen nås fra alle netværk, som serveren er forbundet til. På en cloudserver skal du også tillade porten i udbyderens security group. Brug HTTPS, før du eksponerer instansen for internettet, se TLS-proxy.

   Du kan starte med standardværdierne og først åbne instansen på localhost. For senere at tillade adgang fra andre computere skal du ændre disse to variabler i config/overleaf.rc og OVERLEAF_SITE_URL i config/variables.env og derefter køre bin/up igen for at genoprette containerne.

3. Påkrævede miljøvariabler

   Opdater følgende variabler i config/variables.env:

   Navn	Beskrivelse	Eksempel
   OVERLEAF_SITE_URL	Hvor din Overleaf-instans er offentligt tilgængelig. Dette bruges i offentlige links og ved forbindelser over websockets, så den skal være konfigureret korrekt!	https://overleaf.lilliput.com
   OVERLEAF_EMAIL_FROM_ADDRESS	Denne e-mailadresse bruges som from-adresse for alle udgående e-mails.	[e-mail]
   OVERLEAF_ADMIN_EMAIL	Den e-mailadresse, hvor brugerne kan kontakte den person, der driver sitet.	[e-mail]

   OVERLEAF_SITE_URL er den adresse, brugerne skriver i deres browser, ikke lytteadressen. Medtag porten, når den ikke er 80 (HTTP) eller 443 (HTTPS), for eksempel http://192.168.1.20:8080. Brug ikke http://0.0.0.0. Hvis OVERLEAF_SITE_URL ikke matcher adressen i browseren, kan editoren ikke oprette forbindelse, og links i e-mails og OAuth-callbacks peger det forkerte sted hen.

   Uden en mailserver skal du lade OVERLEAF_EMAIL_FROM_ADDRESS være usat: Overleaf sender så ingen e-mails, og du kan selv give nye brugere deres aktiveringslink, se spørgsmål og svar i Offentlig adgang.

   Sæt også OVERLEAF_SESSION_SECRET til en værdi genereret med openssl rand -hex 32. Uden den logger hver bin/up, der genopretter containeren, og hver opgradering alle brugere ud. Se spørgsmål og svar i Miljøvariabler.

   Når du har opdateret disse miljøvariabler, skal du gemme og lukke filen.

4. Opsæt Sandbox Compile

   Konfigurer derefter TeX Live Full til sandboxed-compiles.md. Åbn config/variables.env, og opdater følgende miljøvariabler:

   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. Start din instans

   Kør følgende for at starte din instans:

   Start the instance

   bin/up
   

   Denne kommando downloader de nødvendige images inklusive TeX Live, opretter containerne (med dine tilpasninger) og starter instansen. Du bør se logoutput fra de forskellige Docker-containere.

   For at starte dem igen senere (uden at tilknytte dig logoutputtet) skal du køre:

   Start without attaching to logs

   bin/start
   

Toolkit bruger docker compose til at administrere Overleaf-Docker-containerne. Toolkit indeholder et sæt scripts, der omslutter docker compose og tager sig af de fleste detaljer for dig.

Hvis alt går vel, bør du kunne se login-siden for din nye Overleaf-instans ved at gå til http://127.0.0.1/ eller http://localhost/ i din browser. Hvis du har ændret OVERLEAF_LISTEN_IP eller OVERLEAF_PORT, skal du i stedet åbne adressen fra tabellen i trinnet Lytteadresse og port, for eksempel http://<server-ip>:8080.

For at kontrollere, hvilken adresse og port webgrænsefladen er udstillet på, skal du køre:

Show the published port

bin/docker-compose port sharelatex 80

Outputtet, for eksempel 0.0.0.0:8080, viser værtens IP-adresse og den port, der bruges. Hvis det viser 127.0.0.1, kan instansen kun nås fra selve serveren.

Afhængigt af din netværkskonfiguration og hvor din Overleaf-instans hostes, kan det være nødvendigt at foretage yderligere konfigurationsændringer. Se Toolkit-indstillingerne for flere detaljer: toolkit-settings.md