Перейти до основного вмісту

Doctor

Overleaf Toolkit постачається зі зручним скриптом doctor, що допомагає в налагодженні. Запустіть bin/doctor, і скрипт виведе інформацію про ваше хост-середовище, вашу конфігурацію та залежності, потрібні Toolkit. Цей вивід також може допомогти нам діагностувати проблеми з вашими інсталяціями Ayakaleaf Pro.
Користувачі Overleaf Pro можуть створити issue на GitHub.Варто додати до свого повідомлення вивід скрипта bin/doctor.

Консультація з Doctor

Запустіть скрипт doctor:
Run doctor
Ви побачите вивід, подібний до наведеного нижче прикладу.

Інформація про хост

Розділ Host Information містить відомості про машину, на якій працює Toolkit (наприклад, дистрибутив і випуск Linux).

Залежності

Розділ Dependencies містить перелік інструментів, необхідних для роботи Toolkit. Якщо інструмент наявний, його буде позначено як status: present з інформацією про версію. Якщо він відсутній, його буде позначено як status: MISSING!, а внизу виводу doctor з’явиться попередження.
Якщо якихось залежностей бракує, Toolkit майже напевно не працюватиме.

Конфігурація

Розділ Configuration містить відомості про файли в каталозі config/. Для config/overleaf.rc doctor виводить деякі ключові значення. Відсутні файли буде позначено як status: MISSING!, а внизу виводу doctor з’явиться попередження.
Примітки до наведеного прикладу:
  • OVERLEAF_DATA_PATH, встановлений у /tmp/overleaf, може бути небезпечним розташуванням для важливих даних.
  • MONGO_ENABLED: false означає, що Toolkit не розгортатиме власну MongoDB; за потреби переконайтеся, що MONGO_URL вказує на зовнішньо керовану MongoDB.
  • У прикладі відсутній config/variables.env.

Попередження

Розділ Warnings підсумовує проблеми, виявлені скриптом doctor. Якщо проблем немає, цей розділ про це повідомить.

Запитання й відповіді

Відповідь: Ні, усі три мають лише інформаційний характер. bin/doctor лише виводить звіт і не зупиняє bin/up.
  • logged in to quay.io: false і попередження Server Pro enabled, but not logged in to quay.io repository: ця перевірка походить з офіційного Toolkit, де образ Server Pro розміщено в приватному реєстрі quay.io. Із SERVER_PRO=true Toolkit завантажує ghcr.io/ayaka-notes/overleaf-pro, який є публічним, тож вхід не потрібен. Ігноруйте це попередження.
  • grep: /root/.docker/config.json: No such file or directory (або інший домашній каталог): перевірка quay.io шукає quay.io у цьому файлі. Docker створює його лише тоді, коли має налаштування для збереження, наприклад після docker login, тому на багатьох серверах його немає. Він не потрібен.
  • perl: warning: Setting locale failed: Toolkit використовує perl лише тут, у bin/doctor, щоб вивести його версію, а Perl попереджає, коли LANG або LC_ALL вказують на локаль, не встановлену на хості. Версія все одно виводиться. Щоб приховати попередження, установіть для цих змінних локаль зі списку locale -a, наприклад C.UTF-8.
Попередження на кшталт Docker daemon is not running, docker not found, Docker Compose not found або про відсутній файл у config/ справді потребують виправлення: без цього Toolkit не зможе запуститися.
Останнє оновлення 2 листопада 2026 р.