> ## Documentation Index > Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 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`: ```bash title="config/overleaf.rc" theme={null} 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://:` | | Za vlastní reverzní proxy (NGINX, Caddy, Cloudflare Tunnel) na stejném hostiteli | `127.0.0.1` | libovolný volný port | URL proxy | | Za [TLS proxy](https://ayakaleaf-pro.mintlify.site/cs/on-premises/configuration/overleaf-toolkit/tls-proxy.md) Toolkitu | `127.0.0.1` | `80` | `https://` | 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`. > [!WARNING] > > 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](https://ayakaleaf-pro.mintlify.site/cs/on-premises/configuration/overleaf-toolkit/tls-proxy.md). 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ů. | `no-reply@lilliput.com` | | `OVERLEAF_ADMIN_EMAIL` | E-mailová adresa, na které mohou uživatelé kontaktovat provozovatele webu. | `it-services@lilliput.com` | `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](https://ayakaleaf-pro.mintlify.site/cs/on-premises/configuration/overleaf-toolkit/authentication/public-access.md). 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í](https://ayakaleaf-pro.mintlify.site/cs/on-premises/configuration/overleaf-toolkit/environment-variables.md). 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](https://ayakaleaf-pro.mintlify.site/cs/on-premises/configuration/overleaf-toolkit/sandboxed-compiles.md "mention"). Otevřete `config/variables.env` a aktualizujte následující proměnné prostředí: ```dotenv title="config/variables.env" wrap theme={null} 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: ```text title="Start the instance" theme={null} 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: ```text title="Start without attaching to logs" theme={null} bin/start ``` > [!NOTE] > > 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/](http://127.0.0.1/) nebo [http://localhost/](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://:8080`. Chcete-li zjistit, na jaké adrese a portu je webové rozhraní publikováno, spusťte: ```text title="Show the published port" theme={null} 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. > [!WARNING] > > 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](https://ayakaleaf-pro.mintlify.site/cs/on-premises/configuration/overleaf-toolkit/toolkit-settings.md "mention") This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.