Przejdź do głównej treści
Jeśli używasz wcześniejszej wersji, w nazwach ścieżek używaj sharelatex zamiast overleaf.
Zamontowanie systemu plików NFS w kontenerze Overleaf jest technicznie możliwe, ale nie jest zalecane i może prowadzić do różnego rodzaju problemów z wydajnością.Jednym z częstych błędów pojawiających się przy kompilacji jest:
W szczególności odradzamy używanie systemów plików opartych na NFS dla danych tymczasowych, takich jak katalogi używane do przechowywania danych kompilacji. Dla poniższych katalogów zalecamy używanie lokalnego dysku roboczego (scratch), najlepiej lokalnego dysku SSD.W konfiguracjach opartych na docker-compose sugerujemy po prostu nadpisanie montowania (bind-mount) z NFS, co pozwala uniknąć zmiany ścieżek w aplikacji. Oto przykładowy fragment konfiguracji docker-compose z użyciem dysku roboczego zamontowanego w /scratch:
docker-compose excerpt
Po aktualizacji nie ma potrzeby migrowania istniejących plików z NFS do nowej lokalizacji. Kompilator LaTeX może odtworzyć wszystkie pliki podczas ponownej pełnej kompilacji.Więcej szczegółów: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
Jeśli uruchamiasz Overleaf w systemie Windows lub macOS, usługa mongo może nie zrestartować się, zgłaszając błąd:
Example error
Może się to zdarzyć, gdy dane MongoDB są montowane przez bind mount z systemu plików, który nie zapewnia wymaganej przez nią semantyki, na przykład z katalogu zamontowanego z systemu Windows. W przypadku Windows z WSL 2 trzymaj Toolkit w linuksowym katalogu domowym Ubuntu i używaj domyślnych bind mountów. Zobacz kontrole MongoDB w przewodniku dla tej platformy.Dla nowej instalacji, która potrzebuje pamięci zarządzanej przez Docker, poniższe nadpisanie używa nazwanych wolumenów (zobacz wskazówki dotyczące przechowywania danych w obrazie MongoDB). W istniejącej instalacji zmiana montowań nie migruje danych: przed przełączeniem wykonaj kopię zapasową i przywróć bazę danych/pamięć podręczną, w przeciwnym razie usługa zobaczy puste wolumeny. Dodaj to do config/docker-compose.override.yml, scalając z istniejącą konfiguracją:
config/docker-compose.override.yml
Więcej informacji: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
Użyj polecenia docker logs redis, aby wyświetlić kopię logów.Jeśli widzisz wiersz Fatal: Can't initialize Background Jobs, pełne wyjście będzie wyglądać mniej więcej tak:
Redis log example
Może to być związane z aktualnie używaną wersją Dockera. Aktualizacja do wersji >= 20.10.10 powinna rozwiązać ten problem.Więcej informacji znajdziesz w zgłoszeniu w projekcie Redis: https://github.com/redis/redis/issues/12362Źródło: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop
Czasami obrazy podglądu/miniatur generowane przez Ayakaleaf Pro mogą zostać utworzone w złej orientacji i wymagać ręcznej korekty. Obrazy te są przechowywane w /var/lib/overleaf/data/template_files/.Przed wprowadzeniem jakichkolwiek zmian zalecamy wykonanie kopii zapasowej tego folderu.Dla każdego problematycznego szablonu wykonaj poniższe kroki:Znajdź identyfikator szablonuPrzejdź do galerii szablonów swojej instancji (/templates/all), otwórz problematyczny szablon i skopiuj identyfikator z adresu URL (na przykład: https://your-instance-url/templates/6645d346c224815e9460a695).Uruchom polecenie korygująceUruchom na hoście Docker poniższe polecenie (zastąp identyfikator szablonu skopiowanym i w razie potrzeby zaktualizuj ścieżkę):docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”Źródło: https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images
Polecenie \write18 jest domyślnie wyłączone w Community Edition, ponieważ wszystkie kompilacje odbywają się w tym samym kontenerze sharelatex; jest to bezpieczniejsze ustawienie domyślne.Jeśli chcesz włączyć je dla pdflatex, utwórz w katalogu głównym projektu plik latexmkrc o następującej zawartości:
latexmkrc
Następnie spróbuj ponownie skompilować projekt.Źródło: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
Te błędy oznaczają, że kontener mongo ciągle ulega awarii i jest restartowany. bin/up uruchamia MongoDB, a następnie wykonuje w nim polecenie, które kończy się niepowodzeniem podczas restartu kontenera. bin/docker-compose ps pokazuje usługę mongo ze statusem Restarting.Aby znaleźć faktyczną przyczynę, przeczytaj log MongoDB:
Najczęstsze przyczyny to:
  • Procesor nie obsługuje AVX. MongoDB 5.0 i nowsze wymagają AVX na x86-64, a log zawiera komunikat MongoDB 5.0+ requires a CPU with AVX support. W maszynie wirtualnej ustaw typ procesora na host, aby instrukcje AVX były przekazywane.
  • Jądro Linux od 6.19 do 7.0.13. MongoDB odmawia uruchomienia na tych jądrach. Obejście opisano w sekcji Wymagania programowe.
  • Dane zostały utworzone przez starszą wersję MongoDB. MongoDB 8.0 nie może bezpośrednio otworzyć danych z wersji 4.4 ani 5.0. Aktualizuj o jedną wersję główną naraz, zobacz Aktualizacja MongoDB.
Jest to oczekiwane w Ayakaleaf Pro i możesz to zignorować. Komunikat jest wyświetlany, gdy OVERLEAF_IS_SERVER_PRO nie ma wartości true, co ma miejsce w obrazie Ayakaleaf Pro. Ayakaleaf Pro nie potrzebuje tej zmiennej, więc pozostaw ją nieustawioną.
Przed uruchomieniem Overleaf kontener wykonuje testy startowe i kończy działanie, gdy jeden z nich się nie powiedzie. Toolkit uruchamia go z restart: always, więc Docker uruchamia go ponownie i ten sam test znowu się nie powiedzie. Dane wyjściowe uruchamiania wskazują nieudany test:
Najczęstsze przyczyny to:
  • Missing required secrets: ustaw OVERLEAF_INVITE_TOKEN_SECRET w config/variables.env, zobacz Zmienne środowiskowe.
  • ShareLaTeX to Overleaf rebranding: konfiguracja nadal używa zmiennych lub ścieżek SHARELATEX_; zmień ich nazwy zgodnie z komunikatem.
  • Błąd po Checking can connect to mongo and redis: Overleaf nie może połączyć się z MongoDB lub Redis. Sprawdź bin/logs mongo i bin/logs redis.
Po usunięciu przyczyny uruchom bin/up -d.
Przy każdym uruchomieniu kontener wykonuje po kolei swoje skrypty startowe, a log podaje nazwę każdego z nich jako *** Running /etc/my_init.d/<script>.... 910_initiate_doc_version_recovery ma coś do zrobienia tylko w instancjach, które kiedyś działały na Overleaf 5.0.1. W każdej innej instancji wypisuje No recovery of doc versions needed. i uruchamianie jest kontynuowane. Jego wyjście trafia też do data/history/doc-version-recovery.log w OVERLEAF_DATA_PATH.Kod wyjścia i koniec bin/docker-compose logs --tail=100 sharelatex pokazują, co się stało:
  • Kod wyjścia 2, a log kończy się *** Init system aborted.: kontener został zatrzymany, na przykład przez bin/stop, docker stop lub Ctrl+C w bin/up. Skrypt z ostatniego wiersza Running to tylko ten, który działał w tym momencie; nie zakończył się błędem. Uruchom kontener ponownie poleceniem bin/up -d i pozwól, aby uruchamianie się zakończyło.
  • Kod wyjścia 1, a log pokazuje *** /etc/my_init.d/<script> failed with status <n>: ten skrypt zakończył się błędem, a jego komunikat znajduje się w wierszach tuż powyżej. Jeśli 910_initiate_doc_version_recovery zakończył się błędem Detected unflushed changes while recovering doc versions, instancja działała na wersji 5.0.1 i nadal ma niezapisane zmiany; postępuj zgodnie z oficjalnym przewodnikiem Doc version recovery.
Ta strona jest wyświetlana, gdy Twoje konto jest zalogowane, ale nie ma uprawnień do otwarcia danej strony, na przykład strony administracyjnej otwartej przez konto, które nie jest administratorem, lub projektu, który nie został Ci udostępniony.Aby otworzyć strony administracyjne, zaloguj się na konto administratora. Istniejący administrator może nadać innemu kontu uprawnienia administratora lub możesz utworzyć takie konto poleceniem create-user --admin, zobacz Zarządzanie użytkownikami. W środowisku deweloperskim (develop/) strony administracyjne wymagają również ADMIN_PRIVILEGE_AVAILABLE=true w develop/dev.env; obraz Ayakaleaf Pro już to ustawia.
Ostatnia modyfikacja 8 listopada 2026