5. Přizpůsobení instance

​

Přizpůsobení instance

Před prvním spuštěním instance Overleafu aktualizujte vlastními údaji dva konfigurační soubory:

Soubor	Čte jej	Nastavuje se zde
config/overleaf.rc	skripty Toolkitu, například bin/up	jak kontejnery běží: OVERLEAF_LISTEN_IP, OVERLEAF_PORT, SERVER_PRO, datové cesty
config/variables.env	aplikace uvnitř kontejneru	jak se Overleaf chová: OVERLEAF_SITE_URL, e-mail, image TeX Live

1. Úprava souboru s proměnnými

   Otevřete config/variables.env ve svém oblíbeném textovém editoru a aktualizujte níže uvedené proměnné prostředí potřebnými hodnotami.

2. Adresa a port pro naslouchání

   Ve výchozím nastavení Toolkit publikuje webové rozhraní na 127.0.0.1:80, takže jej lze otevřít pouze z prohlížeče na samotném serveru. Ostatní počítače dostanou chybu „connection refused“ nebo „server not found“. Chcete-li to změnit, upravte config/overleaf.rc:

   config/overleaf.rc

   OVERLEAF_LISTEN_IP=0.0.0.0
   OVERLEAF_PORT=8080
   

   OVERLEAF_LISTEN_IP je IP adresa hostitele, na kterou se kontejner naváže, a OVERLEAF_PORT je port hostitele. Společně tvoří mapování portů Dockeru OVERLEAF_LISTEN_IP:OVERLEAF_PORT:80. Zvolte hodnoty odpovídající vašemu nastavení:

   Nastavení	OVERLEAF_LISTEN_IP	OVERLEAF_PORT	Otevřít v prohlížeči
   Pouze na tomto počítači (výchozí)	127.0.0.1	80	http://localhost
   Ostatní počítače v LAN nebo z internetu se připojují přímo	0.0.0.0 nebo jedna IP adresa serveru	80 nebo libovolný volný port	http://<server-ip>:<port>
   Za vlastní reverzní proxy (NGINX, Caddy, Cloudflare Tunnel) na stejném hostiteli	127.0.0.1	libovolný volný port	URL proxy
   Za TLS proxy Toolkitu	127.0.0.1	80	https://<your-domain>

   Pokud je port 80 na hostiteli již obsazen, například jiným webovým serverem, nastavte OVERLEAF_PORT na volný port, například 8080. Jinak bin/up selže s chybou bind: address already in use.

   Porty publikované Dockerem obcházejí firewally hostitele, jako jsou ufw a firewalld. S 0.0.0.0 je instance dostupná ze všech sítí, ke kterým je server připojen. Na cloudovém serveru musíte port povolit také v bezpečnostní skupině poskytovatele. Než instanci zpřístupníte z internetu, použijte HTTPS, viz TLS proxy.

   Můžete začít s výchozím nastavením a instanci nejprve otevřít na localhost. Chcete-li později povolit přístup z jiných počítačů, změňte tyto dvě proměnné v config/overleaf.rc a OVERLEAF_SITE_URL v config/variables.env a poté znovu spusťte bin/up, aby se kontejnery znovu vytvořily.

3. Povinné proměnné prostředí

   Aktualizujte v config/variables.env následující proměnné:

   Název	Popis	Příklad
   OVERLEAF_SITE_URL	Adresa, na které je vaše instance Overleafu veřejně dostupná. Používá se ve veřejných odkazech a při připojování přes websockety, proto musí být nakonfigurována správně!	https://overleaf.lilliput.com
   OVERLEAF_EMAIL_FROM_ADDRESS	Tato e-mailová adresa bude použita jako adresa from u všech odchozích e-mailů.	[e-mail]
   OVERLEAF_ADMIN_EMAIL	E-mailová adresa, na které mohou uživatelé kontaktovat provozovatele webu.	[e-mail]

   OVERLEAF_SITE_URL je adresa, kterou uživatelé zadávají do prohlížeče, nikoli adresa pro naslouchání. Uveďte port, pokud nejde o 80 (HTTP) nebo 443 (HTTPS), například http://192.168.1.20:8080. Nepoužívejte http://0.0.0.0. Pokud OVERLEAF_SITE_URL neodpovídá adrese v prohlížeči, editor se nepřipojí a odkazy v e-mailech a OAuth callbacky budou směřovat na špatné místo.

   Pokud nemáte poštovní server, ponechte OVERLEAF_EMAIL_FROM_ADDRESS nenastavené: Overleaf pak neodesílá žádné e-maily a aktivační odkaz můžete novým uživatelům předat sami, viz otázky a odpovědi v části Veřejný přístup.

   Nastavte také OVERLEAF_SESSION_SECRET na hodnotu vygenerovanou pomocí openssl rand -hex 32. Bez něj každé bin/up, které znovu vytvoří kontejner, i každá aktualizace odhlásí všechny uživatele. Viz otázky a odpovědi v části Proměnné prostředí.

   Po aktualizaci těchto proměnných prostředí soubor uložte a zavřete.

4. Nastavení kompilace v sandboxu

   Dále nakonfigurujte TeX Live Full pro sandboxed-compiles.md. Otevřete config/variables.env a aktualizujte následující proměnné prostředí:

   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. Spuštění instance

   Instanci spustíte příkazem:

   Start the instance

   bin/up
   

   Tento příkaz stáhne potřebné image včetně texlive, vytvoří kontejnery (s vašimi úpravami) a spustí instanci. Měli byste vidět výstup logů z různých Docker kontejnerů.

   Chcete-li je později znovu spustit (bez připojení k výstupu logů), spusťte:

   Start without attaching to logs

   bin/start
   

Toolkit používá ke správě Docker kontejnerů Overleafu docker compose. Toolkit poskytuje sadu skriptů, které docker compose obalují a postarají se za vás o většinu detailů.

Pokud vše proběhne v pořádku, měli byste po otevření http://127.0.0.1/ nebo http://localhost/ v prohlížeči vidět přihlašovací stránku své nové instance Overleafu. Pokud jste změnili OVERLEAF_LISTEN_IP nebo OVERLEAF_PORT, otevřete místo toho adresu z tabulky v kroku Adresa a port pro naslouchání, například http://<server-ip>:8080.

Chcete-li zjistit, na jaké adrese a portu je webové rozhraní publikováno, spusťte:

Show the published port

bin/docker-compose port sharelatex 80

Výstup, například 0.0.0.0:8080, ukazuje používanou IP adresu a port hostitele. Pokud ukazuje 127.0.0.1, je instance dostupná pouze ze samotného serveru.

V závislosti na konfiguraci vaší sítě a na tom, kde je vaše instance Overleafu hostována, může být nutné provést další změny konfigurace. Další podrobnosti najdete v nastavení Toolkitu: toolkit-settings.md