Hoppa till huvudinnehåll
Om du använder en tidigare version ska du använda sharelatex i stället för overleaf i sökvägar.
Det är tekniskt möjligt att montera ett NFS-filsystem i en Overleaf-container, men det rekommenderas inte och kan leda till olika typer av prestandafel.Ett vanligt fel som uppstår vid kompilering är:
Vi avråder särskilt från att använda NFS-baserade filsystem för tillfälliga data, till exempel de kataloger som används för kompileringsdata. Vi rekommenderar att du använder en lokal arbetsdisk, helst en lokal SSD, för följande kataloger.För docker-compose-baserade installationer föreslår vi att du helt enkelt åsidosätter bind-monteringen från NFS, vilket gör att du slipper ändra sökvägar i applikationen. Här är ett utdrag ur en docker-compose-konfiguration som använder en arbetsdisk monterad på /scratch:
docker-compose excerpt
Du behöver inte migrera några befintliga filer från NFS till deras nya plats efter uppdateringen. LaTeX-kompilatorn kan återskapa alla filer genom att köra en fullständig kompilering igen.Mer information finns på: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
Om du kör Overleaf på Windows eller macOS kan tjänsten mongo misslyckas med att starta om, med felet:
Example error
Detta kan inträffa när MongoDB-data bind-monteras från ett filsystem som inte har den semantik som krävs, till exempel en katalog som monterats från Windows. För Windows med WSL 2 behåller du Toolkit i Ubuntus Linux-hemkatalog och använder standardbind-monteringarna. Se plattformsguidens MongoDB-kontroller.För en ny installation som behöver Docker-hanterad lagring använder följande override namngivna volymer (se lagringsvägledningen för MongoDB-avbildningen). På en befintlig installation migreras inte data när monteringarna ändras: säkerhetskopiera och återställ databasen/cachen innan du byter, annars ser tjänsten tomma volymer. Lägg till detta i config/docker-compose.override.yml och slå ihop det med eventuell befintlig konfiguration:
config/docker-compose.override.yml
Mer information finns på: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
Använd kommandot docker logs redis för att skriva ut en kopia av loggarna.Om du ser raden Fatal: Can't initialize Background Jobs ser hela utdata ut ungefär så här:
Redis log example
Detta kan ha att göra med den Docker-version som används. En uppdatering till version >= 20.10.10 bör lösa problemet.Mer information finns i Redis uppströmsärende: https://github.com/redis/redis/issues/12362Referens: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop
Ibland kan de förhandsgransknings-/miniatyrbilder som genereras av Ayakaleaf Pro skapas med fel orientering och kräva manuella åtgärder för att rättas. Dessa bilder lagras i /var/lib/overleaf/data/template_files/.Vi rekommenderar att du säkerhetskopierar den här mappen innan du gör några ändringar.Du behöver följa stegen nedan för varje berörd mall:Hitta mallens ID: Gå till din instans mallgalleri (/templates/all), öppna en berörd mall och kopiera ID:t från URL:en (till exempel: https://your-instance-url/templates/6645d346c224815e9460a695). Kör korrigeringskommandot: Kör följande kommando från Docker-värden (ersätt mall-ID:t med det du kopierade och uppdatera sökvägen vid behov):docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”Referens: https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images
Kommandot \write18 är inaktiverat som standard i Community Edition eftersom alla kompileringar sker i samma sharelatex-container; detta är det säkrare standardvalet.Om du vill aktivera det för pdflatex skapar du en latexmkrc-fil i projektets rot med följande innehåll:
latexmkrc
Försök sedan kompilera om.Referens: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
Dessa fel innebär att containern mongo kraschar och startas om gång på gång. bin/up startar MongoDB och kör sedan ett kommando i den, vilket misslyckas medan containern startas om. bin/docker-compose ps visar tjänsten mongo som Restarting.För att hitta den faktiska orsaken läser du MongoDB-loggen:
Vanliga orsaker är:
  • Processorn saknar stöd för AVX. MongoDB 5.0 och senare kräver AVX på x86-64, och loggen visar MongoDB 5.0+ requires a CPU with AVX support. I en virtuell maskin anger du processortypen host så att AVX skickas vidare.
  • Linuxkärna 6.19 till 7.0.13. MongoDB vägrar att starta på dessa kärnor. Se Programvarukrav för en lösning.
  • Data skapades av en äldre MongoDB-version. MongoDB 8.0 kan inte öppna data från 4.4 eller 5.0 direkt. Uppgradera en huvudversion i taget, se Uppdatera MongoDB.
Detta är förväntat med Ayakaleaf Pro och du kan ignorera det. Meddelandet skrivs ut när OVERLEAF_IS_SERVER_PRO inte är true, vilket är fallet i Ayakaleaf Pro-imagen. Ayakaleaf Pro behöver inte den här variabeln, så lämna den oangiven.
Innan Overleaf startar kör containern startkontroller och avslutas om någon av dem misslyckas. Toolkit kör den med restart: always, så Docker startar den igen och samma kontroll misslyckas igen. Startutdata anger vilken kontroll som misslyckades:
Vanliga orsaker är:
  • Missing required secrets: ange OVERLEAF_INVITE_TOKEN_SECRET i config/variables.env, se Miljövariabler.
  • ShareLaTeX to Overleaf rebranding: konfigurationen använder fortfarande SHARELATEX_-variabler eller sökvägar; byt namn på dem enligt meddelandet.
  • Ett fel efter Checking can connect to mongo and redis: Overleaf når inte MongoDB eller Redis. Kontrollera bin/logs mongo och bin/logs redis.
När du har åtgärdat orsaken kör du bin/up -d.
Vid varje start kör containern sina startskript ett efter ett, och loggen namnger vart och ett som *** Running /etc/my_init.d/<script>.... 910_initiate_doc_version_recovery har bara något att göra på instanser som en gång körde Overleaf 5.0.1. På alla andra instanser skriver det ut No recovery of doc versions needed. och starten fortsätter. Dess utdata skrivs också till data/history/doc-version-recovery.log i OVERLEAF_DATA_PATH.Avslutningskoden och slutet av bin/docker-compose logs --tail=100 sharelatex visar vad som hände:
  • Avslutningskod 2, och loggen slutar med *** Init system aborted.: containern stoppades, till exempel av bin/stop, docker stop eller Ctrl+C på bin/up. Skriptet på den sista Running-raden är bara det som kördes i det ögonblicket, det misslyckades inte. Starta containern igen med bin/up -d och låt starten slutföras.
  • Avslutningskod 1, och loggen visar *** /etc/my_init.d/<script> failed with status <n>: det skriptet misslyckades, och dess fel finns på raderna precis ovanför. Om 910_initiate_doc_version_recovery misslyckades med Detected unflushed changes while recovering doc versions körde instansen 5.0.1 och har fortfarande ändringar som inte har flushats; följ den officiella guiden Doc version recovery.
Den här sidan visas när ditt konto är inloggat men inte får öppna sidan, till exempel en adminsida som öppnas av ett konto som inte är administratör, eller ett projekt som inte delas med dig.Logga in med ett administratörskonto för att öppna adminsidorna. En befintlig administratör kan göra ett annat konto till administratör, eller så kan du skapa ett med kommandot create-user --admin, se Användarhantering. I utvecklingsmiljön (develop/) kräver adminsidorna dessutom ADMIN_PRIVILEGE_AVAILABLE=true i develop/dev.env; Ayakaleaf Pro-imagen anger det redan.
Senast ändrad 8 november 2026