Spring til hovedindhold
Hvis du bruger en tidligere version, skal du bruge sharelatex i stedet for overleaf i stinavne.
Det er teknisk muligt at montere et NFS-filsystem i en Overleaf-container, men det anbefales ikke og kan give forskellige typer ydelsesfejl.En almindelig fejl, der ses ved kompileringer, er:
Vi fraråder især at bruge NFS-baserede filsystemer til midlertidige data, såsom de mapper, der bruges til kompileringsdata. Vi anbefaler at bruge en lokal scratch-disk, helst en lokal SSD, til følgende mapper.For docker-compose-baserede opsætninger foreslår vi blot at tilsidesætte bind-mounten fra NFS, hvilket undgår at ændre stier i applikationen. Her er et eksempel på et uddrag af en docker-compose-konfiguration, der bruger en scratch-disk monteret på /scratch:
docker-compose excerpt
Der er ikke behov for at migrere eksisterende filer fra NFS til deres nye placering efter opdateringen. LaTeX-compileren kan genskabe alle filerne med en ny fuld kompilering.Se flere detaljer her: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
Hvis du kører Overleaf på Windows eller macOS, kan tjenesten mongo fejle ved genstart med fejlen:
Example error
Det kan ske, når MongoDB-data bind-monteres fra et filsystem, der ikke leverer den nødvendige semantik, f.eks. en Windows-monteret mappe. Ved Windows med WSL 2 skal du placere Toolkit i Ubuntus Linux-hjemmemappe og bruge standard-bind-mounts. Se platformvejledningens MongoDB-kontroller.For en ny installation, der har brug for Docker-administreret lagring, bruger følgende override navngivne volumes (se vejledningen om lagring til MongoDB-imaget). På en eksisterende installation migreres data ikke, når du ændrer mounts: tag en sikkerhedskopi af databasen/cachen, og gendan den, før du skifter, ellers vil tjenesten se tomme volumes. Tilføj dette til config/docker-compose.override.yml, og flet det med eventuel eksisterende konfiguration:
config/docker-compose.override.yml
Se flere oplysninger her: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
Brug kommandoen docker logs redis til at udskrive en kopi af logfilerne.Hvis du ser linjen Fatal: Can't initialize Background Jobs, vil det fulde output se nogenlunde sådan ud:
Redis log example
Det kan hænge sammen med den Docker-version, der aktuelt bruges. En opdatering til en version >= 20.10.10 bør løse problemet.Se flere oplysninger i Redis’ upstream-issue: https://github.com/redis/redis/issues/12362Reference: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop
Af og til kan de forhåndsvisnings-/miniaturebilleder, som Ayakaleaf Pro genererer, blive oprettet med forkert orientering og kræve manuel indgriben for at blive rettet. Disse billeder gemmes i /var/lib/overleaf/data/template_files/.Vi anbefaler, at du tager en sikkerhedskopi af denne mappe, før du foretager ændringer.Du skal følge nedenstående trin for hver berørt skabelon:Find skabelonens IDGå til din instans’ skabelongalleri (/templates/all), åbn en berørt skabelon, og kopiér ID’et fra URL’en (for eksempel: https://your-instance-url/templates/6645d346c224815e9460a695).Kør rettelseskommandoenKør følgende kommando fra Docker-værten (erstat skabelon-ID’et med det, du kopierede, og opdater stien, hvis det er relevant):docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”Reference: https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images
Kommandoen \write18 er som standard deaktiveret i Community Edition, fordi alle kompileringer sker i den samme sharelatex-container; dette er den sikreste standard.Hvis du vil aktivere den for pdflatex, skal du oprette en latexmkrc-fil i roden af dit projekt med følgende indhold:
latexmkrc
Prøv derefter at kompilere igen.Reference: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
Disse fejl betyder, at mongo-containeren bliver ved med at gå ned og genstarte. bin/up starter MongoDB og kører derefter en kommando inde i den, som mislykkes, mens containeren genstarter. bin/docker-compose ps viser mongo-tjenesten som Restarting.For at finde den egentlige årsag skal du læse MongoDB-loggen:
Almindelige årsager er:
  • CPU’en har ingen AVX-understøttelse. MongoDB 5.0 og nyere kræver AVX på x86-64, og loggen viser MongoDB 5.0+ requires a CPU with AVX support. I en virtuel maskine skal du sætte CPU-typen til host, så AVX videregives.
  • Linux-kerne 6.19 til 7.0.13. MongoDB nægter at starte på disse kerner. Se Softwarekrav for at finde en løsning.
  • Dataene blev oprettet af en ældre MongoDB-version. MongoDB 8.0 kan ikke åbne data fra 4.4 eller 5.0 direkte. Opgrader én hovedversion ad gangen, se Opdatering af MongoDB.
Dette er forventet med Ayakaleaf Pro, og du kan ignorere det. Beskeden udskrives, når OVERLEAF_IS_SERVER_PRO ikke er true, hvilket er tilfældet i Ayakaleaf Pro-imaget. Ayakaleaf Pro har ikke brug for denne variabel, så lad den være usat.
Før Overleaf starter, kører containeren opstartstjek og afslutter, når et af dem mislykkes. Toolkit kører den med restart: always, så Docker starter den igen, og det samme tjek mislykkes igen. Opstartsoutputtet angiver det mislykkede tjek:
Almindelige årsager er:
  • Missing required secrets: sæt OVERLEAF_INVITE_TOKEN_SECRET i config/variables.env, se Miljøvariabler.
  • ShareLaTeX to Overleaf rebranding: konfigurationen bruger stadig SHARELATEX_-variabler eller -stier; omdøb dem, som beskeden angiver.
  • En fejl efter Checking can connect to mongo and redis: Overleaf kan ikke nå MongoDB eller Redis. Kontrollér bin/logs mongo og bin/logs redis.
Når årsagen er rettet, skal du køre bin/up -d.
Ved hver start kører containeren sine opstartsscripts efter hinanden, og loggen navngiver hvert enkelt som *** Running /etc/my_init.d/<script>.... 910_initiate_doc_version_recovery har kun noget at gøre på instanser, der engang har kørt Overleaf 5.0.1. På alle andre instanser udskriver det No recovery of doc versions needed., og starten fortsætter. Outputtet skrives også til data/history/doc-version-recovery.log i OVERLEAF_DATA_PATH.Afslutningskoden og slutningen af bin/docker-compose logs --tail=100 sharelatex fortæller, hvad der skete:
  • Afslutningskode 2, og loggen slutter med *** Init system aborted.: containeren blev stoppet, f.eks. med bin/stop, docker stop eller Ctrl+C på bin/up. Scriptet i den sidste Running-linje er blot det, der kørte i det øjeblik; det fejlede ikke. Start containeren igen med bin/up -d, og lad starten blive færdig.
  • Afslutningskode 1, og loggen viser *** /etc/my_init.d/<script> failed with status <n>: det script fejlede, og fejlen står i linjerne lige ovenover. Hvis 910_initiate_doc_version_recovery fejlede med Detected unflushed changes while recovering doc versions, har instansen kørt 5.0.1 og har stadig ikke-flushede redigeringer; følg den officielle vejledning Doc version recovery.
Denne side vises, når din konto er logget ind, men ikke har tilladelse til at åbne siden, for eksempel en administratorside, der åbnes af en konto, som ikke er administrator, eller et projekt, der ikke er delt med dig.For at åbne administratorsiderne skal du logge ind med en administratorkonto. En eksisterende administrator kan gøre en anden konto til administrator, eller du kan oprette en med kommandoen create-user --admin, se Brugeradministration. I udviklingsmiljøet (develop/) kræver administratorsiderne desuden ADMIN_PRIVILEGE_AVAILABLE=true i develop/dev.env; Ayakaleaf Pro-imaget sætter den allerede.
Sidst ændret 8. november 2026