Naar hoofdinhoud gaan
Als je een oudere versie gebruikt, gebruik dan sharelatex in plaats van overleaf in padnamen.
Het mounten van een NFS-bestandssysteem in een Overleaf-container is technisch mogelijk, maar wordt niet aanbevolen en kan tot verschillende soorten prestatieproblemen leiden.Een veelvoorkomende fout bij compilaties is:
We raden met name af om door NFS ondersteunde bestandssystemen te gebruiken voor tijdelijke gegevens, zoals de mappen voor compilatiegegevens. We raden aan om voor de volgende mappen een lokale scratchschijf te gebruiken, bij voorkeur een lokale SSD.Voor opstellingen op basis van docker-compose raden we aan om simpelweg de bind-mount vanaf NFS te overschrijven, zodat je geen paden in de applicatie hoeft te wijzigen. Hier is een voorbeeld van een fragment uit een docker-compose-configuratie met een scratchschijf die op /scratch is gemount:
docker-compose excerpt
Het is niet nodig om bestaande bestanden na de update van de NFS naar hun nieuwe locatie te migreren. De LaTeX-compiler kan alle bestanden opnieuw aanmaken met een volledige compilatierun.Zie voor meer details: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
Als je Overleaf op Windows of macOS draait, kan het herstarten van de service mongo mislukken met de foutmelding:
Example error
Dit kan gebeuren wanneer MongoDB-gegevens via een bind-mount worden gekoppeld vanaf een bestandssysteem dat niet de vereiste semantiek biedt, zoals een door Windows gemounte map. Houd bij Windows met WSL 2 de Toolkit in de Linux-thuismap van Ubuntu en gebruik de standaard bind-mounts. Zie de MongoDB-controles in de platformhandleiding.Voor een nieuwe installatie die door Docker beheerde opslag nodig heeft, gebruikt de volgende override benoemde volumes (zie de richtlijnen voor opslag van de MongoDB-image). Bij een bestaande installatie worden gegevens niet gemigreerd door mounts te wijzigen: maak een back-up van de database/cache en zet die terug voordat je overstapt, anders ziet de service lege volumes. Voeg dit toe aan config/docker-compose.override.yml en voeg het samen met een eventuele bestaande configuratie:
config/docker-compose.override.yml
Zie voor meer informatie: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
Gebruik de opdracht docker logs redis om een kopie van de logs weer te geven.Als je de regel Fatal: Can't initialize Background Jobs ziet, ziet de volledige uitvoer er ongeveer zo uit:
Redis log example
Dit kan verband houden met de Docker-versie die momenteel wordt gebruikt. Updaten naar een versie >= 20.10.10 zou dit probleem moeten oplossen.Zie voor meer informatie de upstream-issue van Redis: https://github.com/redis/redis/issues/12362Referentie: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop
Soms worden de voorbeeld-/miniatuurafbeeldingen die Ayakaleaf Pro genereert in de verkeerde oriëntatie aangemaakt en is handmatig ingrijpen nodig om dit te corrigeren. Deze afbeeldingen worden opgeslagen in /var/lib/overleaf/data/template_files/.We raden aan om een back-up van deze map te maken voordat je wijzigingen aanbrengt.Volg de onderstaande stappen voor elk getroffen sjabloon:Zoek de sjabloon-IDGa naar de sjabloongalerij van je instantie (/templates/all), open een getroffen sjabloon en kopieer de ID uit de URL (bijvoorbeeld: https://your-instance-url/templates/6645d346c224815e9460a695).Voer de correctieopdracht uitVoer de volgende opdracht uit vanaf de Docker-host (vervang de sjabloon-ID door de ID die je hebt gekopieerd en pas het pad zo nodig aan):docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”Referentie: https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images
De opdracht \write18 is in de Community Edition standaard uitgeschakeld, omdat alle compilaties binnen dezelfde container sharelatex plaatsvinden; dit is de veiligere standaardinstelling.Als je deze voor pdflatex wilt inschakelen, maak dan in de root van je project een bestand latexmkrc aan met de volgende inhoud:
latexmkrc
Probeer daarna opnieuw te compileren.Referentie: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
Deze fouten betekenen dat de container mongo steeds crasht en opnieuw opstart. bin/up start MongoDB en voert daarna een opdracht in de container uit, die mislukt terwijl de container opnieuw opstart. bin/docker-compose ps toont de service mongo als Restarting.Lees het MongoDB-log om de werkelijke oorzaak te vinden:
Veelvoorkomende oorzaken zijn:
  • De CPU heeft geen AVX-ondersteuning. MongoDB 5.0 en later vereisen AVX op x86-64, en het log toont MongoDB 5.0+ requires a CPU with AVX support. Stel in een virtuele machine het CPU-type in op host, zodat AVX wordt doorgegeven.
  • Linux-kernel 6.19 tot en met 7.0.13. MongoDB weigert op deze kernels te starten. Zie Softwarevereisten voor de workaround.
  • De gegevens zijn aangemaakt door een oudere MongoDB-versie. MongoDB 8.0 kan gegevens van 4.4 of 5.0 niet rechtstreeks openen. Upgrade één hoofdversie tegelijk, zie MongoDB bijwerken.
Dit is verwacht gedrag bij Ayakaleaf Pro en je kunt het negeren. Het bericht wordt weergegeven wanneer OVERLEAF_IS_SERVER_PRO niet true is, wat het geval is in het Ayakaleaf Pro-image. Ayakaleaf Pro heeft deze variabele niet nodig, dus laat deze niet ingesteld.
Voordat Overleaf start, voert de container opstartcontroles uit en stopt hij wanneer een daarvan mislukt. De Toolkit draait de container met restart: always, dus Docker start hem opnieuw en dezelfde controle mislukt opnieuw. De opstartuitvoer noemt de mislukte controle:
Veelvoorkomende oorzaken zijn:
  • Missing required secrets: stel OVERLEAF_INVITE_TOKEN_SECRET in config/variables.env in, zie Omgevingsvariabelen.
  • ShareLaTeX to Overleaf rebranding: de configuratie gebruikt nog SHARELATEX_-variabelen of -paden; hernoem ze zoals het bericht aangeeft.
  • Een fout na Checking can connect to mongo and redis: Overleaf kan MongoDB of Redis niet bereiken. Controleer bin/logs mongo en bin/logs redis.
Voer na het oplossen van de oorzaak bin/up -d uit.
Bij elke start voert de container zijn opstartscripts na elkaar uit, en het log noemt elk script als *** Running /etc/my_init.d/<script>.... 910_initiate_doc_version_recovery heeft alleen werk te doen op instanties die ooit Overleaf 5.0.1 hebben gedraaid. Op elke andere instantie drukt het No recovery of doc versions needed. af en gaat de start door. De uitvoer ervan gaat ook naar data/history/doc-version-recovery.log in OVERLEAF_DATA_PATH.De exitcode en het einde van bin/docker-compose logs --tail=100 sharelatex laten zien wat er is gebeurd:
  • Exitcode 2, en het log eindigt met *** Init system aborted.: de container is gestopt, bijvoorbeeld door bin/stop, docker stop of Ctrl+C bij bin/up. Het script in de laatste Running-regel is alleen het script dat op dat moment draaide; het is niet mislukt. Start de container opnieuw met bin/up -d en laat de start voltooien.
  • Exitcode 1, en het log toont *** /etc/my_init.d/<script> failed with status <n>: dat script is mislukt, en de fout staat in de regels er direct boven. Als 910_initiate_doc_version_recovery mislukte met Detected unflushed changes while recovering doc versions, heeft de instantie 5.0.1 gedraaid en heeft ze nog niet-geflushte bewerkingen; volg de officiële handleiding Doc version recovery.
Deze pagina wordt getoond wanneer je account is ingelogd maar de pagina niet mag openen, bijvoorbeeld een beheerpagina die wordt geopend door een account dat geen beheerder is, of een project dat niet met je is gedeeld.Log in met een beheerdersaccount om de beheerpagina’s te openen. Een bestaande beheerder kan een ander account beheerder maken, of je kunt er een aanmaken met de opdracht create-user --admin, zie Gebruikersbeheer. In de ontwikkelomgeving (develop/) hebben beheerpagina’s ook ADMIN_PRIVILEGE_AVAILABLE=true in develop/dev.env nodig; de Ayakaleaf Pro-image stelt dit al in.
Laatst gewijzigd op 8 november 2026