Přejít na hlavní obsah

Doktor

Overleaf Toolkit obsahuje praktický skript doctor, který pomáhá s laděním. Spusťte bin/doctor a skript vypíše informace o vašem hostitelském prostředí, vaší konfiguraci a závislostech, které Toolkit potřebuje. Tento výstup nám také může pomoci diagnostikovat problémy s vašimi instalacemi Ayakaleaf Pro.
Uživatelé Overleaf Pro mohou založit issue na GitHubu.Je dobré do zprávy přiložit výstup skriptu bin/doctor.

Konzultace s Doktorem

Spusťte skript doctor:
Run doctor
Zobrazí se výstup podobný níže uvedenému příkladu.

Informace o hostiteli

Sekce Host Information obsahuje informace o stroji, na kterém Toolkit běží (například distribuci a vydání Linuxu).

Závislosti

Sekce Dependencies uvádí nástroje, které Toolkit ke své činnosti potřebuje. Pokud je nástroj k dispozici, bude uveden jako status: present spolu s informací o verzi. Pokud chybí, bude uveden jako status: MISSING! a na konec výstupu doctor se přidá varování.
Pokud některé závislosti chybí, Toolkit téměř jistě nebude fungovat.

Konfigurace

Sekce Configuration obsahuje informace o souborech v adresáři config/. Pro config/overleaf.rc vypíše doctor některé klíčové hodnoty. Chybějící soubory budou uvedeny jako status: MISSING! a na konec výstupu doctor se přidá varování.
Poznámky k výše uvedenému příkladu:
  • OVERLEAF_DATA_PATH nastavená na /tmp/overleaf nemusí být bezpečným umístěním pro důležitá data.
  • MONGO_ENABLED: false znamená, že Toolkit nezřídí vlastní MongoDB; v případě potřeby zajistěte, aby MONGO_URL odkazovala na externě spravovanou MongoDB.
  • V příkladu chybí config/variables.env.

Varování

Sekce Warnings shrnuje problémy zjištěné skriptem doctor. Pokud žádné problémy nejsou, tato sekce to uvede.

Otázky a odpovědi

Odpověď: Ne, všechna tři jsou pouze informativní. bin/doctor jen vypisuje zprávu, nezastavuje bin/up.
  • logged in to quay.io: false a varování Server Pro enabled, but not logged in to quay.io repository: tato kontrola pochází z oficiálního Toolkitu, kde je image Server Pro v soukromém registru quay.io. S SERVER_PRO=true stahuje Toolkit ghcr.io/ayaka-notes/overleaf-pro, který je veřejný, takže přihlášení není potřeba. Toto varování ignorujte.
  • grep: /root/.docker/config.json: No such file or directory (nebo jiný domovský adresář): kontrola quay.io hledá v tomto souboru quay.io. Docker jej zapisuje, jen když má co uložit, například po docker login, takže na mnoha serverech chybí. Není potřeba.
  • perl: warning: Setting locale failed: Toolkit používá perl pouze zde, v bin/doctor, k vypsání jeho verze, a Perl varuje, když LANG nebo LC_ALL uvádí locale, které na hostiteli není nainstalované. Verze se přesto vypíše. Chcete-li varování umlčet, nastavte tyto proměnné na locale uvedené v locale -a, například C.UTF-8.
Varování jako Docker daemon is not running, docker not found, Docker Compose not found nebo chybějící soubor v config/ je naopak potřeba vyřešit: bez nich Toolkit nemůže nastartovat.
Naposledy změněno 2. listopadu 2026