Hopp til hovedinnhold

Doctor

Overleaf Toolkit leveres med et praktisk doctor-skript som hjelper med feilsøking. Kjør bin/doctor, så skriver skriptet ut informasjon om vertsmiljøet ditt, konfigurasjonen din og avhengighetene Toolkit trenger. Denne utdataen kan også hjelpe oss med å diagnostisere problemer i Ayakaleaf Pro-installasjonene dine.
Brukere av Overleaf Pro kan opprette en issue på GitHub.Det er lurt å inkludere utdataen fra bin/doctor-skriptet i meldingen din.

Konsultere Doctor

Kjør doctor-skriptet:
Run doctor
Du vil se utdata som ligner på eksempelet nedenfor.

Vertsinformasjon

Delen Host Information inneholder informasjon om maskinen som kjører Toolkit (for eksempel Linux-distribusjon og -versjon).

Avhengigheter

Delen Dependencies viser verktøyene som kreves for at Toolkit skal fungere. Hvis et verktøy finnes, vises det som status: present med versjonsinformasjon. Hvis det mangler, vises det som status: MISSING!, og en advarsel legges til nederst i utdataen fra doctor.
Hvis noen avhengigheter mangler, vil Toolkit nesten helt sikkert ikke fungere.

Konfigurasjon

Delen Configuration inneholder informasjon om filene i katalogen config/. For config/overleaf.rc skriver doctor ut noen sentrale verdier. Manglende filer vises som status: MISSING!, og en advarsel legges til nederst i utdataen fra doctor.
Merknader til eksempelet ovenfor:
  • OVERLEAF_DATA_PATH satt til /tmp/overleaf er kanskje ikke et trygt sted for viktige data.
  • MONGO_ENABLED: false betyr at Toolkit ikke vil klargjøre sin egen MongoDB; sørg for at MONGO_URL peker til en eksternt administrert MongoDB ved behov.
  • config/variables.env mangler i eksempelet.

Advarsler

Delen Warnings oppsummerer problemer som doctor-skriptet har oppdaget. Hvis det ikke finnes noen problemer, vil denne delen angi det.

Spørsmål og svar

Svar: Nei, alle tre er bare informative. bin/doctor skriver bare ut en rapport, den stopper ikke bin/up.
  • logged in to quay.io: false og advarselen Server Pro enabled, but not logged in to quay.io repository: denne kontrollen kommer fra det offisielle Toolkit, der Server Pro-imaget ligger i et privat quay.io-register. Med SERVER_PRO=true henter Toolkit ghcr.io/ayaka-notes/overleaf-pro, som er offentlig, så ingen innlogging er nødvendig. Ignorer denne advarselen.
  • grep: /root/.docker/config.json: No such file or directory (eller en annen hjemmekatalog): quay.io-kontrollen ser etter quay.io i denne filen. Docker skriver den bare når den har innstillinger å lagre, for eksempel etter docker login, så den mangler på mange servere. Den er ikke nødvendig.
  • perl: warning: Setting locale failed: Toolkit bruker perl bare her, i bin/doctor, for å skrive ut versjonen, og Perl advarer når LANG eller LC_ALL angir en lokalitet som ikke er installert på verten. Versjonen skrives likevel ut. For å fjerne advarselen setter du disse variablene til en lokalitet som vises av locale -a, for eksempel C.UTF-8.
Advarsler som Docker daemon is not running, docker not found, Docker Compose not found eller en manglende fil i config/ må derimot rettes: Toolkit kan ikke starte uten dem.
Sist endret 2. november 2026