Перейти к основному содержанию
Если вы используете более раннюю версию, используйте в путях sharelatex вместо overleaf.
Монтирование файловой системы NFS в контейнере Overleaf технически возможно, но не рекомендуется и может приводить к различным проблемам с производительностью.Одна из типичных ошибок при компиляции:
В частности, мы не рекомендуем использовать файловые системы на базе NFS для временных данных, например каталогов, используемых для данных компиляции. Для следующих каталогов рекомендуем использовать локальный рабочий диск, предпочтительно локальный SSD.Для установок на основе docker-compose мы предлагаем просто переопределить bind-монтирование из 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-монтирование из файловой системы, которая не обеспечивает необходимую ей семантику, например из каталога, смонтированного из Windows. Для Windows с WSL 2 храните Toolkit в домашнем каталоге Linux в Ubuntu и используйте bind-монтирования по умолчанию. См. проверки 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 должно решить эту проблему.Подробнее см. issue в апстриме 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 и в нём остались несброшенные правки; следуйте официальному руководству Doc version recovery.
Эта страница отображается, когда вы вошли в учётную запись, но вам не разрешено открывать страницу, например когда страница администратора открыта учётной записью, не являющейся администратором, или проект не предоставлен вам в общий доступ.Чтобы открыть страницы администратора, войдите с учётной записью администратора. Существующий администратор может назначить администратором другую учётную запись, либо вы можете создать её командой create-user --admin, см. Управление пользователями. В среде разработки (develop/) для страниц администратора также требуется ADMIN_PRIVILEGE_AVAILABLE=true в develop/dev.env; в образе Ayakaleaf Pro это значение уже задано.
Последнее изменение 8 ноября 2026 г.