Hopp til hovedinnhold
Hvis du bruker en tidligere versjon, bruker du sharelatex i stedet for overleaf i stinavn.
Det er teknisk mulig å montere et NFS-filsystem i en Overleaf-container, men det anbefales ikke og kan føre til ulike typer ytelsesfeil.En vanlig feil som oppstår ved kompilering, er:
Vi fraråder spesielt å bruke NFS-baserte filsystemer for flyktige data, som katalogene som brukes til kompileringsdata. Vi anbefaler å bruke en lokal scratch-disk, helst en lokal SSD, for følgende kataloger.For docker-compose-baserte oppsett foreslår vi at du ganske enkelt overstyrer bind-monteringen fra NFS, slik at du unngår å endre stier i applikasjonen. Her er et eksempelutdrag fra en docker-compose-konfigurasjon som bruker en scratch-disk montert på /scratch:
docker-compose excerpt
Det er ikke nødvendig å migrere eksisterende filer fra NFS til den nye plasseringen etter oppdateringen. LaTeX-kompilatoren kan gjenskape alle filene ved å kjøre en full kompilering på nytt.For mer informasjon, se: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
Hvis du kjører Overleaf på Windows eller macOS, kan det hende mongo-tjenesten ikke klarer å starte på nytt, med feilen:
Example error
Dette kan skje når MongoDB-data bind-monteres fra et filsystem som ikke gir den nødvendige semantikken, for eksempel en katalog montert fra Windows. For Windows med WSL 2 holder du Toolkit under Ubuntus hjemmekatalog i Linux og bruker standard bind-monteringer. Se MongoDB-sjekkene i plattformveiledningen.For en ny installasjon som trenger Docker-administrert lagring, bruker følgende override navngitte volumer (se veiledningen for lagring i MongoDB-imaget). På en eksisterende installasjon migrerer ikke endrede monteringer dataene: ta sikkerhetskopi av og gjenopprett databasen/hurtigbufferen før du bytter, ellers vil tjenesten se tomme volumer. Legg til dette i config/docker-compose.override.yml, slått sammen med eventuell eksisterende konfigurasjon:
config/docker-compose.override.yml
For mer informasjon, se: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
Bruk kommandoen docker logs redis for å skrive ut en kopi av loggene.Hvis du ser linjen Fatal: Can't initialize Background Jobs, vil hele utdataene se omtrent slik ut:
Redis log example
Dette kan ha sammenheng med Docker-versjonen som er i bruk. Oppdatering til en versjon >= 20.10.10 bør løse problemet.For mer informasjon, se Redis-saken oppstrøms: https://github.com/redis/redis/issues/12362Referanse: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop
Av og til kan forhåndsvisnings-/miniatyrbildene som genereres av Ayakaleaf Pro, bli opprettet med feil orientering og kreve manuell korrigering. Disse bildene lagres i /var/lib/overleaf/data/template_files/.Vi anbefaler å ta sikkerhetskopi av denne mappen før du gjør endringer.Du må følge trinnene nedenfor for hver berørt mal:Finn mal-ID-enGå til malgalleriet i instansen din (/templates/all), åpne en berørt mal og kopier ID-en fra URL-en (for eksempel: https://your-instance-url/templates/6645d346c224815e9460a695).Kjør korreksjonskommandoenKjør følgende kommando fra Docker-verten (erstatt mal-ID-en med den du kopierte, og oppdater stien om nødvendig):docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”Referanse: https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images
Kommandoen \write18 er deaktivert som standard i Community Edition fordi alle kompileringer skjer i den samme sharelatex-containeren; dette er den sikreste standardinnstillingen.Hvis du vil aktivere den for pdflatex, oppretter du en latexmkrc-fil i roten av prosjektet ditt med følgende innhold:
latexmkrc
Prøv deretter å kompilere på nytt.Referanse: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
Disse feilene betyr at mongo-containeren stadig krasjer og starter på nytt. bin/up starter MongoDB og kjører deretter en kommando inne i den, som mislykkes mens containeren starter på nytt. bin/docker-compose ps viser mongo-tjenesten som Restarting.For å finne den faktiske årsaken leser du MongoDB-loggen:
Vanlige årsaker er:
  • CPU-en har ikke AVX-støtte. MongoDB 5.0 og nyere krever AVX på x86-64, og loggen viser MongoDB 5.0+ requires a CPU with AVX support. I en virtuell maskin setter du CPU-typen til host slik at AVX sendes videre.
  • Linux-kjerne 6.19 til 7.0.13. MongoDB nekter å starte på disse kjernene. Se Programvarekrav for en løsning.
  • Dataene ble opprettet av en eldre MongoDB-versjon. MongoDB 8.0 kan ikke åpne data fra 4.4 eller 5.0 direkte. Oppgrader én hovedversjon om gangen, se Oppdatere MongoDB.
Dette er forventet med Ayakaleaf Pro, og du kan ignorere det. Meldingen skrives ut når OVERLEAF_IS_SERVER_PRO ikke er true, noe som er tilfellet i Ayakaleaf Pro-imaget. Ayakaleaf Pro trenger ikke denne variabelen, så la den være uangitt.
Før Overleaf starter, kjører containeren oppstartskontroller og avslutter når én av dem mislykkes. Toolkit kjører den med restart: always, så Docker starter den igjen, og den samme kontrollen mislykkes på nytt. Oppstartsutdataene navngir kontrollen som mislyktes:
Vanlige årsaker er:
  • Missing required secrets: sett OVERLEAF_INVITE_TOKEN_SECRET i config/variables.env, se Miljøvariabler.
  • ShareLaTeX to Overleaf rebranding: konfigurasjonen bruker fortsatt SHARELATEX_-variabler eller -stier; gi dem nye navn slik meldingen sier.
  • En feil etter Checking can connect to mongo and redis: Overleaf kan ikke nå MongoDB eller Redis. Sjekk bin/logs mongo og bin/logs redis.
Når du har rettet årsaken, kjører du bin/up -d.
Ved hver oppstart kjører containeren oppstartsskriptene sine etter hverandre, og loggen navngir hvert av dem som *** Running /etc/my_init.d/<script>.... 910_initiate_doc_version_recovery har bare noe å gjøre på instanser som en gang kjørte Overleaf 5.0.1. På alle andre instanser skriver den ut No recovery of doc versions needed., og oppstarten fortsetter. Utdataene går også til data/history/doc-version-recovery.log i OVERLEAF_DATA_PATH.Avslutningskoden og slutten av bin/docker-compose logs --tail=100 sharelatex forteller hva som skjedde:
  • Avslutningskode 2, og loggen slutter med *** Init system aborted.: containeren ble stoppet, for eksempel av bin/stop, docker stop eller Ctrl+C på bin/up. Skriptet i den siste Running-linjen er bare det som kjørte i det øyeblikket; det mislyktes ikke. Start containeren igjen med bin/up -d og la oppstarten fullføres.
  • Avslutningskode 1, og loggen viser *** /etc/my_init.d/<script> failed with status <n>: det skriptet mislyktes, og feilen står i linjene rett over. Hvis 910_initiate_doc_version_recovery mislyktes med Detected unflushed changes while recovering doc versions, kjørte instansen 5.0.1 og har fortsatt endringer som ikke er skrevet ut; følg den offisielle veiledningen Doc version recovery.
Denne siden vises når kontoen din er logget inn, men ikke har tillatelse til å åpne siden, for eksempel en administrasjonsside som åpnes av en konto som ikke er administrator, eller et prosjekt som ikke er delt med deg.For å åpne administrasjonssidene logger du inn med en administratorkonto. En eksisterende administrator kan gjøre en annen konto til administrator, eller du kan opprette en med kommandoen create-user --admin, se Brukeradministrasjon. I utviklingsmiljøet (develop/) krever administrasjonssidene også ADMIN_PRIVILEGE_AVAILABLE=true i develop/dev.env; Ayakaleaf Pro-imaget setter den allerede.
Sist endret 8. november 2026