Přejít na hlavní obsah
Zde jsme shromáždili odpovědi na některé často kladené otázky o Ayakaleaf Pro.

Základní otázky

Ne. Ayakaleaf Pro je zcela zdarma. Nejde o zkušební verzi a nevyžaduje žádnou licenci.
Ano. Ayakaleaf Pro obsahuje všechny funkce Overleaf Server Pro včetně integrace Git-Bridge. Obsahuje také vybrané funkce z platformy Overleaf SaaS. Ayakaleaf Pro nadále vyvíjíme a vylepšujeme.
Overleaf Server Pro stojí přibližně $300 na uživatele ročně. Vyžaduje alespoň 10 licencí, takže nasazení začínají zhruba na $3,000 ročně. Menší veřejné zakázky v USA uvádějí roční náklady přibližně $320–$370 na uživatele. Server Pro je tak drahý, zejména pro menší týmy. Zdokumentované nákupy a ceny najdete v části #information-and-price-about-overleaf-server-pro.
Overleaf Server Pro běžně používají vládní organizace. Nasazují jej v privátních sítích a přísně kontrolují přístup. Kvůli ochraně citlivých dat se jeho funkce vyhýbají výměně dat se službami třetích stran. Pokud potřebujete synchronizaci s GitHubem, AI nebo podobné propojené funkce, Overleaf doporučuje předplatné své platformy SaaS.
Ayakaleaf Pro je open source. Kód kontrolujeme pomocí nástrojů, jako je Codex Security, abychom posílili jeho bezpečnost a spolehlivost. Pokud nezapnete synchronizaci dat se třetími stranami, vaše data zůstávají na vašem serveru. Ayakaleaf Pro neobsahuje žádnou telemetrii, která by odesílala vaše data jinam.
Vynaložíme veškeré úsilí, abychom tento projekt dlouhodobě udržovali.
Ayakaleaf Pro je komunitní fork. Jeho kód a integrované funkce pocházejí z příspěvků komunity. Je licencován pod AGPL v3. Nasazení mohou být v souladu s touto licencí, pokud splní její požadavky.
Projekt se původně v roce 2024 jmenoval Overleaf Pro. Vývoj byl na čas pozastaven a koncem roku 2025 znovu obnoven. V prvním čtvrtletí roku 2026 Overleaf přejmenoval svůj tarif předplatného s AI na Pro. Komunita také upozornila, že název Overleaf Pro by mohl vytvářet rizika v oblasti ochranných známek a vydávání se za někoho jiného. Uživatelé by si mohli myslet, že jde o oficiální projekt.Abychom tomuto zmatení předešli, přejmenovali jsme projekt na Ayakaleaf Pro. Název lze číst jako „Ayaka-notes Overleaf Pro“. Správce (můžete mi říkat ayaka!) přispívá do komunitního vývoje Overleaf již od studentských let, tedy více než pět let. Tato zkušenost podporuje náš závazek k dlouhodobé údržbě.
Od roku 2026 vydala open-source komunita mnoho LaTeX editorů vytvořených pomocí AI, včetně OpenAI Prism. Ayakaleaf Pro uchovává vaše data a služby na vašem vlastním serveru. Díky tomu máte nad svým nasazením a daty přímou kontrolu.Mnoho experimentálních komunitních editorů nemá zavedený plán dlouhodobé údržby. Platformy třetích stran pro kompilaci LaTeXu mohou také ukončit provoz, pokud nemají dostatek uživatelů nebo příjmů. Ayakaleaf Pro poskytuje veškerý zdrojový kód a umožňuje vám hostovat všechny služby sami. I kdyby se údržba zastavila, vaše stávající služba hostovaná u vás by mohla dál běžet.
Byl přejmenován na ayaka-notes/ayakaleaf-pro spolu s přejmenováním projektu (viz Q08). Nebyl archivován ani nahrazen: jde o tentýž repozitář a GitHub přesměrovává staré odkazy ayaka-notes/overleaf-pro i Git remoty na nový název. Docker image si ponechává svůj název ghcr.io/ayaka-notes/overleaf-pro, takže nemusíte měnit config/overleaf.rc ani config/version.

Funkce

Aktuální seznam funkcí najdete v naší dokumentaci. Pokud byste chtěli, abychom přidali nějakou funkci, neváhejte na GitHubu založit issue (s požadavkem na funkci). Požadované funkce se budeme snažit implementovat, ale vývoj vyžaduje čas a nemůžeme zaručit, že každá funkce bude dodána okamžitě.
Příspěvky jsou vítány, ale jejich přijetí není zaručeno. Každý PR posuzujeme podle jeho dopadu na základní kódovou bázi Overleafu, náročnosti údržby a přínosu pro uživatele. Hodnotné příspěvky se budeme snažit sloučit a udržovat.Můžeme však odmítnout PR, které zavádějí nadměrné změny, sestávají z nezkontrolovaného nebo špatně pochopeného kódu generovaného AI („vibe coding“) nebo přidávají funkce, jejichž dlouhodobá údržba by byla obtížná.
Při vydání nové funkce obvykle aktualizujeme dokumentaci. Podrobné pokyny k nastavení a vysvětlení dostupných proměnných prostředí najdete v příslušné dokumentaci.
Python Runner spouští Python v prohlížeči uživatele pomocí Pyodide 0.29.3, nikoli na serveru. Balíčky, které váš kód importuje, načítá z balíčků vestavěných v Pyodide, jako jsou NumPy, pandas a Matplotlib. Balíčky instalované pomocí pip a další balíčky nejsou k dispozici. Na serveru není nic potřeba konfigurovat.
Ne. Kontrola pravopisu nemá slovník pro japonštinu ani čínštinu, proto tyto jazyky nejsou v seznamu jazyků pro kontrolu pravopisu. Uživatelé mohou kontrolu pravopisu pro projekt vypnout v nastavení editoru.Pokud nechcete, aby bylo slovo označováno jako chybně napsané, klikněte na něj pravým tlačítkem a zvolte Add to dictionary. Přidaná slova se ukládají do vašeho účtu a platí pro všechny vaše projekty. Chcete-li je zkontrolovat nebo odebrat, otevřete nastavení editoru a poté Spelling and language → Dictionary → Edit. Přidáním slov se nepřidává nový jazyk pro kontrolu pravopisu.
Žádný instalátor pluginů neexistuje. Funkce jsou moduly ve zdrojovém kódu v services/web/modules, jsou zabudované do Docker image a zapínají se nastaveními popsanými v této dokumentaci. Chcete-li přidat vlastní, přidejte modul do zdrojového kódu a sestavte si vlastní image.

Nasazení

Většině uživatelů doporučujeme nasazení pomocí Toolkitu. Podpora Kubernetes je experimentální: Použití Kubernetes ukazuje manifesty, které jsme otestovali s jednou nebo několika replikami, ale cluster zvyšuje provozní složitost a náročnost údržby. Sandboxed Compiles vytvářejí své kompilační kontejnery přes Docker socket, takže každý uzel, na kterém běží Ayakaleaf Pro, potřebuje Docker Engine. Konfigurace pro CRI-O, Podman ani Quadlet neposkytujeme.
Postupujte podle našeho návodu k horizontálnímu škálování. Můžete nasadit více instancí Overleafu a nakonfigurovat load balancer, který mezi ně bude rozdělovat provoz.
Pokud máte existující instanci Overleaf Server Pro, rádi vám pomůžeme s migrací na Ayakaleaf Pro. Kontaktujte nás prosím e-mailem nebo prostřednictvím issues.
Ne. Ayakaleaf Pro musí být poskytován z kořene domény. Použijte vyhrazenou doménu nebo subdoménu, například https://overleaf.example.com.
Ano. Toolkit běží na Linuxu, na macOS s Docker Desktop a na Windows s WSL 2 a Docker Desktop. Pro sdílené a produkční servery doporučujeme Linux. Návody pro macOS a Windows zahrnují i nastavení Sandboxed Compiles.Samostatný docker-compose.yml neposkytujeme. Konfiguraci Compose, kterou Toolkit používá, zobrazíte spuštěním bin/docker-compose config v adresáři Toolkitu.
Odinstalační skript neexistuje. V adresáři Toolkitu:
  1. Zastavte a odstraňte kontejnery pomocí bin/docker-compose down.
  2. Smažte data. Ve výchozím nastavení jsou v adresáři data/ Toolkitu. Pokud jste v config/overleaf.rc změnili OVERLEAF_DATA_PATH, MONGO_DATA_PATH, REDIS_DATA_PATH nebo GIT_BRIDGE_DATA_PATH, smažte i tyto adresáře. Tento krok nelze vrátit zpět, proto si nejprve vytvořte zálohu, pokud byste data mohli potřebovat.
  3. Smažte adresář Toolkitu.
  4. Odstraňte Docker image, které vypíšete pomocí docker images: ghcr.io/ayaka-notes/overleaf-pro, image git-bridge, mongo, redis a image TeX Live.
Spusťte tyto příkazy v adresáři Toolkitu:
  • bin/stop zastaví všechny kontejnery, bin/start je znovu spustí. Kontejnery zůstanou zachovány, takže uživatelé zůstanou přihlášeni.
  • bin/up -d vytvoří kontejnery a spustí je na pozadí. Spusťte jej po změně config/variables.env, config/overleaf.rc nebo config/version: znovu vytvoří kontejnery, jejichž konfigurace se změnila, a teprve poté se změny projeví. bin/stop a bin/start je nepoužijí.
  • bin/docker-compose restart sharelatex restartuje pouze kontejner Overleafu, bez použití změn konfigurace.
Pokud jsou uživatelé odhlášeni pokaždé, když bin/up znovu vytvoří kontejner, nastavte OVERLEAF_SESSION_SECRET, viz otázky a odpovědi v části Proměnné prostředí.
Do aplikace, kterou vytvoříte u poskytovatele, nikoli do Ayakaleaf Pro. Pro žádnou z těchto integrací neexistuje v config/variables.env nastavení callbacku: Ayakaleaf Pro sestavuje každou callback URL z OVERLEAF_SITE_URL a posílá ji poskytovateli, který ji odmítne, pokud neodpovídá té, která je pro aplikaci zaregistrována. Stačí ji tedy zaregistrovat u poskytovatele a nastavit OVERLEAF_SITE_URL na adresu, kterou uživatelé otevírají.Pokud OVERLEAF_SITE_URL změníte, například na novou doménu, aktualizujte URL také u všech poskytovatelů, jinak propojení selže.
Ve výchozím nastavení zůstává vše na lokálním disku serveru, v adresáři data/ Toolkitu: data/overleaf (soubory projektů, historie a výstupy kompilace), data/mongo a data/redis. Pro instance s méně než 1000 uživateli doporučujeme lokální disk s pravidelnými zálohami.Image Ayakaleaf Pro zabírá přibližně 5 GB. Minimum 40 GB uvedené v Úvodu platí pro Sandboxed Compiles, jejichž image texlive-full zabírají každý přibližně 28 GB. Bez Sandboxed Compiles probíhají kompilace uvnitř kontejneru sharelatex se základním schématem TeX Live a balíčky latexmk, texcount, synctex, etoolbox a xetex, takže mnoho projektů selže kvůli chybějícím balíčkům. Adresář data/ pak roste s vašimi projekty a jejich historií; zkontrolujete jej pomocí du -sh data/*.
Ano, pokud Windows zůstanou vzhůru a Docker Desktop zůstane spuštěný. Zapněte Start Docker Desktop when you sign in to your computer, ponechte v Toolkitu zásady restart: always a při napájení ze sítě vypněte automatický spánek a hibernaci. Obrazovka se vypnout může; chování při zavření víka notebooku je samostatné nastavení. Zavření terminálu Ubuntu po bin/up -d odpojené kontejnery nezastaví. Ukončení Docker Desktop, pozastavení jeho enginu nebo spuštění wsl --shutdown službu přeruší.Resource Saver v Docker Desktop není totéž co spánek Windows: uplatní se, když neběží žádné kontejnery, takže běžící stack Ayakaleafu není nečinný jen proto, že nikdo neupravuje. Po restartu Windows nastavení spouštění při přihlášení stále vyžaduje, aby se někdo přihlásil. Kontroly a kroky obnovy najdete v části Zajištění dostupnosti instance. Pokud dostupnost nesmí záviset na interaktivním přihlášení k ploše, i nadále doporučujeme Linux.
Tento návod používá backend WSL 2. Ten vyžaduje zapnutou virtualizaci CPU v BIOS/UEFI, funkci Windows Virtual Machine Platform a funkční instalaci WSL 2. Plná funkce Hyper-V je samostatný backend Docker Desktop a pro toto nastavení WSL není nutná.Zkontrolujte Správce úloh → Výkon → CPU → Virtualizace a v PowerShellu spusťte wsl --list --verbose. Chyby jako 0x80370102 mohou znamenat, že je vypnutá virtualizace, funkce Windows nebo hypervisor při spouštění. Viz kroky řešení problémů s instalací na Windows s odkazy na opravy od Microsoftu a Dockeru. Po zapnutí požadovaných funkcí restartujte Windows; přeinstalace Ayakaleafu nemůže opravit engine Dockeru, který se nespustí.

LaTeX

Pokud zapnete Sandbox Compiles, kompilace každého uživatele běží v samostatném Docker kontejneru a je izolována od kompilací ostatních uživatelů. Shell Escape je u Sandbox Compiles ve výchozím nastavení zapnutý.
Náš obraz TeX Live Full pro Sandbox Compiles jsme v posledních třech letech vylepšovali. Ve většině případů se projekty, které se kompilují na overleaf.com, správně zkompilují i v Ayakaleaf Pro. Pokud požadované písmo není k dispozici, nahrajte jej do svého projektu ručně.
Nahrajte prosím svůj projekt na oficiální web Overleaf, zapněte sdílení odkazu pouze pro čtení a vložte odkaz do issue na GitHubu.Prošetříme a opravíme všechny chyby, které brání kompilaci projektu v Ayakaleaf Pro, pokud se úspěšně kompiluje na oficiálním webu Overleaf. Problémy s kompilací mimo tento rozsah naše podpora nepokrývá.
Naposledy změněno 8. listopadu 2026