Перейти до основного вмісту
Якщо ви використовуєте старішу версію, вказуйте у шляхах sharelatex замість overleaf.
Монтування файлової системи NFS у контейнер Overleaf технічно можливе, але не рекомендоване і може призводити до різних проблем із продуктивністю.Одна з поширених помилок, що виникає під час компіляції:
Зокрема, ми не радимо використовувати файлові системи на основі NFS для тимчасових даних, наприклад для каталогів із даними компіляції. Для наведених нижче каталогів радимо використовувати локальний робочий диск, бажано локальний SSD.Для інсталяцій на основі docker-compose пропонуємо просто перевизначити bind-mount з NFS, що дає змогу не змінювати шляхи в застосунку. Ось приклад фрагмента конфігурації docker-compose з використанням робочого диска, змонтованого в /scratch:
docker-compose excerpt
Після оновлення немає потреби переносити наявні файли з NFS у нове місце. Компілятор LaTeX може повторно створити всі файли під час повної компіляції.Докладніше див.: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
Якщо ви запускаєте Overleaf у Windows або macOS, служба mongo може не перезапуститися з такою помилкою:
Example error
Це може статися, коли дані MongoDB підключено через bind mount з файлової системи, яка не забезпечує потрібної їй семантики, наприклад з каталогу, змонтованого з Windows. Для Windows з WSL 2 тримайте Toolkit у домашньому каталозі Linux в Ubuntu й використовуйте bind mount за замовчуванням. Див. перевірки MongoDB у посібнику для цієї платформи.Для нової інсталяції, якій потрібне сховище під керуванням Docker, наведене нижче перевизначення використовує іменовані томи (див. рекомендації щодо зберігання даних для образу MongoDB). У наявній інсталяції зміна точок монтування не переносить дані: перед перемиканням створіть резервну копію бази даних і кешу та відновіть їх, інакше сервіс побачить порожні томи. Додайте це до config/docker-compose.override.yml, об’єднавши з наявною конфігурацією:
config/docker-compose.override.yml
Докладніше див.: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
Скористайтеся командою docker logs redis, щоб вивести копію журналів.Якщо ви бачите рядок Fatal: Can't initialize Background Jobs, повний вивід виглядатиме приблизно так:
Redis log example
Це може бути пов’язано з версією Docker, що використовується. Оновлення до версії >= 20.10.10 має розв’язати цю проблему.Докладніше див. відповідну проблему в Redis: https://github.com/redis/redis/issues/12362Джерело: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop
Іноді зображення попереднього перегляду/мініатюри, згенеровані Ayakaleaf Pro, можуть мати неправильну орієнтацію, і їх потрібно виправити вручну. Ці зображення зберігаються в /var/lib/overleaf/data/template_files/.Перед внесенням будь-яких змін радимо створити резервну копію цієї папки.Для кожного проблемного шаблону потрібно виконати наведені нижче кроки:Знайдіть ID шаблонуПерейдіть до галереї шаблонів вашого екземпляра (/templates/all), відкрийте проблемний шаблон і скопіюйте ID з URL-адреси (наприклад: https://your-instance-url/templates/6645d346c224815e9460a695).Виконайте команду виправленняВиконайте наведену нижче команду на хості Docker (замініть ID шаблону на скопійований і за потреби оновіть шлях):docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”Джерело: https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images
Команду \write18 у Community Edition за замовчуванням вимкнено, оскільки всі компіляції відбуваються в одному контейнері sharelatex; це безпечніше налаштування за замовчуванням.Якщо ви хочете ввімкнути її для pdflatex, створіть у корені проєкту файл latexmkrc з таким вмістом:
latexmkrc
Потім спробуйте скомпілювати повторно.Джерело: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
Ці помилки означають, що контейнер mongo постійно аварійно завершується й перезапускається. bin/up запускає MongoDB, а потім виконує в ньому команду, яка не вдається, поки контейнер перезапускається. bin/docker-compose ps показує сервіс mongo у стані Restarting.Щоб знайти справжню причину, прочитайте журнал MongoDB:
Поширені причини:
  • Процесор не підтримує AVX. MongoDB 5.0 і новішим версіям потрібна підтримка AVX на x86-64, а в журналі з’являється MongoDB 5.0+ requires a CPU with AVX support. У віртуальній машині встановіть тип процесора host, щоб AVX передавався до неї.
  • Ядро Linux від 6.19 до 7.0.13. MongoDB відмовляється запускатися на цих ядрах. Обхідний шлях див. у розділі Вимоги до програмного забезпечення.
  • Дані створено старішою версією MongoDB. MongoDB 8.0 не може безпосередньо відкрити дані з 4.4 або 5.0. Оновлюйтеся на одну мажорну версію за раз, див. Оновлення MongoDB.
Для Ayakaleaf Pro це очікувано, і це повідомлення можна ігнорувати. Воно виводиться, коли OVERLEAF_IS_SERVER_PRO не дорівнює true, що й має місце в образі Ayakaleaf Pro. Ayakaleaf Pro не потребує цієї змінної, тож залиште її незаданою.
Перш ніж Overleaf запуститься, контейнер виконує стартові перевірки й завершує роботу, якщо одна з них не проходить. Toolkit запускає його з restart: always, тож Docker знову запускає його, і та сама перевірка знову не проходить. У стартовому виводі зазначено, яка перевірка не пройшла:
Поширені причини:
  • Missing required secrets: установіть OVERLEAF_INVITE_TOKEN_SECRET у config/variables.env, див. Змінні середовища.
  • ShareLaTeX to Overleaf rebranding: конфігурація досі використовує змінні або шляхи SHARELATEX_; перейменуйте їх, як зазначено в повідомленні.
  • Помилка після Checking can connect to mongo and redis: Overleaf не може підключитися до MongoDB або Redis. Перевірте bin/logs mongo і bin/logs redis.
Після усунення причини виконайте bin/up -d.
Під час кожного запуску контейнер по черзі виконує свої стартові скрипти, і журнал називає кожен із них як *** Running /etc/my_init.d/<script>.... 910_initiate_doc_version_recovery має що робити лише на екземплярах, які колись працювали на Overleaf 5.0.1. На будь-якому іншому екземплярі він виводить No recovery of doc versions needed., і запуск продовжується. Його вивід також записується до data/history/doc-version-recovery.log в OVERLEAF_DATA_PATH.Код завершення та кінець виводу bin/docker-compose logs --tail=100 sharelatex показують, що сталося:
  • Код завершення 2, і журнал закінчується рядком *** Init system aborted.: контейнер було зупинено, наприклад командою bin/stop, docker stop або натисканням Ctrl+C під час bin/up. Скрипт в останньому рядку Running — це лише той, що виконувався в той момент, і він не завершився з помилкою. Запустіть контейнер знову за допомогою bin/up -d і дочекайтеся завершення запуску.
  • Код завершення 1, і журнал показує *** /etc/my_init.d/<script> failed with status <n>: цей скрипт завершився з помилкою, і її текст наведено в рядках безпосередньо вище. Якщо 910_initiate_doc_version_recovery завершився з помилкою Detected unflushed changes while recovering doc versions, екземпляр працював на 5.0.1 і досі має не збережені на диск (unflushed) зміни; дотримуйтеся офіційного посібника Doc version recovery.
Ця сторінка з’являється, коли ви ввійшли у свій обліковий запис, але не маєте дозволу відкривати цю сторінку, наприклад сторінку адміністратора, відкриту обліковим записом, що не є адміністратором, або проєкт, яким з вами не поділилися.Щоб відкрити сторінки адміністратора, увійдіть з обліковим записом адміністратора. Наявний адміністратор може зробити інший обліковий запис адміністратором, або ви можете створити його командою create-user --admin, див. Керування користувачами. У середовищі розробки (develop/) для сторінок адміністратора також потрібно ADMIN_PRIVILEGE_AVAILABLE=true у develop/dev.env; в образі Ayakaleaf Pro це вже встановлено.
Останнє оновлення 8 листопада 2026 р.