Přejít na hlavní obsah
Pokud používáte starší verzi, použijte v názvech cest sharelatex místo overleaf.
Připojení souborového systému NFS v kontejneru Overleafu je technicky možné, ale nedoporučuje se a může vést k různým typům výkonnostních chyb.Jedna z běžných chyb, které se při kompilaci objevují, je:
Zejména nedoporučujeme používat souborové systémy založené na NFS pro dočasná data, například pro adresáře používané pro data kompilace. Pro následující adresáře doporučujeme použít lokální pracovní (scratch) disk, nejlépe lokální SSD.U instalací založených na docker-compose doporučujeme jednoduše přepsat bind-mount z NFS, čímž se vyhnete změnám cest v aplikaci. Zde je příklad výňatku z konfigurace docker-compose s použitím pracovního disku připojeného do /scratch:
docker-compose excerpt
Po aktualizaci není nutné migrovat žádné existující soubory z NFS na jejich nové umístění. Kompilátor LaTeXu dokáže všechny soubory znovu vytvořit při další úplné kompilaci.Další podrobnosti viz: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
Pokud provozujete Overleaf na Windows nebo macOS, služba mongo se nemusí podařit restartovat a zobrazí se chyba:
Example error
K tomu může dojít, když jsou data MongoDB připojena pomocí bind mount ze souborového systému, který neposkytuje požadovanou sémantiku, například z adresáře připojeného z Windows. Pro Windows s WSL 2 ponechte Toolkit v linuxovém domovském adresáři Ubuntu a použijte výchozí bind mounty. Viz kontroly MongoDB v návodu pro danou platformu.Pro novou instalaci, která potřebuje úložiště spravované Dockerem, používá následující override pojmenované svazky (viz doporučení k úložišti v image MongoDB). U stávající instalace změna připojení data nepřenese: před přepnutím zazálohujte a obnovte databázi/cache, jinak služba uvidí prázdné svazky. Přidejte toto do config/docker-compose.override.yml a slučte to s případnou stávající konfigurací:
config/docker-compose.override.yml
Další informace viz: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
Pomocí příkazu docker logs redis vypište kopii logů.Pokud vidíte řádek Fatal: Can't initialize Background Jobs, celý výstup bude vypadat přibližně takto:
Redis log example
To může souviset s aktuálně používanou verzí Dockeru. Problém by měl vyřešit upgrade na verzi >= 20.10.10.Další informace najdete v upstream issue Redisu: https://github.com/redis/redis/issues/12362Reference: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop
Občas mohou být náhledové obrázky/miniatury generované Ayakaleaf Pro vytvořeny ve špatné orientaci a jejich oprava vyžaduje ruční zásah. Tyto obrázky jsou uloženy v /var/lib/overleaf/data/template_files/.Před provedením jakýchkoli změn doporučujeme tuto složku zálohovat.Pro každou dotčenou šablonu budete muset provést následující kroky:Zjištění ID šablonyPřejděte do galerie šablon vaší instance (/templates/all), otevřete dotčenou šablonu a zkopírujte ID z URL (například: https://your-instance-url/templates/6645d346c224815e9460a695).Spuštění opravného příkazuSpusťte z hostitele Dockeru následující příkaz (nahraďte ID šablony tím, které jste zkopírovali, a případně upravte cestu):docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”Reference: https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images
Příkaz \write18 je v Community Edition ve výchozím nastavení zakázán, protože všechny kompilace probíhají ve stejném kontejneru sharelatex; toto je bezpečnější výchozí nastavení.Pokud jej chcete pro pdflatex povolit, vytvořte v kořenovém adresáři projektu soubor latexmkrc s následujícím obsahem:
latexmkrc
Poté zkuste projekt znovu zkompilovat.Reference: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
Tyto chyby znamenají, že kontejner mongo neustále padá a restartuje se. bin/up spustí MongoDB a poté v něm spustí příkaz, který selže, zatímco se kontejner restartuje. bin/docker-compose ps zobrazuje službu mongo ve stavu Restarting.Skutečnou příčinu zjistíte z logu MongoDB:
Časté příčiny jsou:
  • CPU nepodporuje AVX. MongoDB 5.0 a novější vyžaduje na x86-64 AVX a log zobrazuje MongoDB 5.0+ requires a CPU with AVX support. Ve virtuálním počítači nastavte typ CPU na host, aby se AVX předávalo dál.
  • Linuxové jádro 6.19 až 7.0.13. MongoDB se na těchto jádrech odmítá spustit. Řešení najdete v části Softwarové požadavky.
  • Data byla vytvořena starší verzí MongoDB. MongoDB 8.0 nedokáže přímo otevřít data z verze 4.4 nebo 5.0. Provádějte upgrade vždy o jednu hlavní verzi, viz Aktualizace MongoDB.
U Ayakaleaf Pro je to očekávané chování a můžete to ignorovat. Zpráva se vypíše, když OVERLEAF_IS_SERVER_PRO není true, což je případ image Ayakaleaf Pro. Ayakaleaf Pro tuto proměnnou nepotřebuje, proto ji nenastavujte.
Než se Overleaf spustí, kontejner provede startovací kontroly a ukončí se, pokud některá z nich selže. Toolkit jej spouští s restart: always, takže jej Docker znovu spustí a stejná kontrola znovu selže. Startovací výstup uvádí, která kontrola selhala:
Časté příčiny jsou:
  • Missing required secrets: nastavte OVERLEAF_INVITE_TOKEN_SECRET v config/variables.env, viz Proměnné prostředí.
  • ShareLaTeX to Overleaf rebranding: konfigurace stále používá proměnné nebo cesty SHARELATEX_; přejmenujte je podle zprávy.
  • Chyba po Checking can connect to mongo and redis: Overleaf se nemůže připojit k MongoDB nebo Redis. Zkontrolujte bin/logs mongo a bin/logs redis.
Po odstranění příčiny spusťte bin/up -d.
Při každém spuštění kontejner postupně spouští své startovací skripty a log každý z nich uvádí jako *** Running /etc/my_init.d/<script>.... 910_initiate_doc_version_recovery má co dělat pouze na instancích, které kdysi provozovaly Overleaf 5.0.1. Na jakékoli jiné instanci vypíše No recovery of doc versions needed. a spouštění pokračuje. Jeho výstup se také zapisuje do data/history/doc-version-recovery.log v OVERLEAF_DATA_PATH.Co se stalo, prozradí návratový kód a konec výstupu bin/docker-compose logs --tail=100 sharelatex:
  • Návratový kód 2 a log končí *** Init system aborted.: kontejner byl zastaven, například pomocí bin/stop, docker stop nebo Ctrl+C při bin/up. Skript na posledním řádku Running je jen ten, který v tu chvíli běžel; neselhal. Spusťte kontejner znovu pomocí bin/up -d a nechte spuštění dokončit.
  • Návratový kód 1 a log ukazuje *** /etc/my_init.d/<script> failed with status <n>: tento skript selhal a jeho chyba je na řádcích těsně nad tím. Pokud 910_initiate_doc_version_recovery selhal s Detected unflushed changes while recovering doc versions, instance provozovala verzi 5.0.1 a stále má neuložené úpravy; postupujte podle oficiálního návodu Doc version recovery.
Tato stránka se zobrazí, když je váš účet přihlášený, ale nemá oprávnění stránku otevřít, například administrátorskou stránku otevřenou účtem, který není administrátorem, nebo projekt, který s vámi není sdílen.Chcete-li otevřít administrátorské stránky, přihlaste se administrátorským účtem. Stávající administrátor může z jiného účtu udělat administrátora, nebo jej můžete vytvořit příkazem create-user --admin, viz Správa uživatelů. Ve vývojovém prostředí (develop/) vyžadují administrátorské stránky také ADMIN_PRIVILEGE_AVAILABLE=true v develop/dev.env; image Ayakaleaf Pro jej již nastavuje.
Naposledy změněno 8. listopadu 2026