Hoppa till huvudinnehåll

Doktorn

Overleaf Toolkit levereras med ett praktiskt doctor-skript som hjälper till vid felsökning. Kör bin/doctor så skriver skriptet ut information om din värdmiljö, din konfiguration och de beroenden som Toolkit behöver. Utdata kan också hjälpa oss att diagnostisera problem i dina Ayakaleaf Pro-installationer.
Användare av Overleaf Pro kan skapa ett ärende på GitHub.Det är en bra idé att inkludera utdata från skriptet bin/doctor i ditt meddelande.

Rådfråga doktorn

Kör doctor-skriptet:
Run doctor
Du kommer att se utdata som liknar exemplet nedan.

Värdinformation

Avsnittet Host Information innehåller information om maskinen som kör Toolkit (till exempel Linux-distribution och version).

Beroenden

Avsnittet Dependencies listar de verktyg som krävs för att Toolkit ska fungera. Om ett verktyg finns listas det som status: present med versionsinformation. Om det saknas listas det som status: MISSING! och en varning läggs till längst ner i utdata från doctor.
Om några beroenden saknas kommer Toolkit nästan säkert inte att fungera.

Konfiguration

Avsnittet Configuration innehåller information om filerna i katalogen config/. För config/overleaf.rc skriver doktorn ut några viktiga värden. Saknade filer listas som status: MISSING! och en varning läggs till längst ner i utdata från doctor.
Anmärkningar om exemplet ovan:
  • OVERLEAF_DATA_PATH satt till /tmp/overleaf är kanske inte en säker plats för viktiga data.
  • MONGO_ENABLED: false innebär att Toolkit inte tillhandahåller en egen MongoDB; se vid behov till att MONGO_URL pekar på en externt hanterad MongoDB.
  • config/variables.env saknas i exemplet.

Varningar

Avsnittet Warnings sammanfattar problem som doctor-skriptet har upptäckt. Om det inte finns några problem anges det i det här avsnittet.

Frågor och svar

Svar: Nej, alla tre är enbart informativa. bin/doctor skriver bara ut en rapport, den stoppar inte bin/up.
  • logged in to quay.io: false och varningen Server Pro enabled, but not logged in to quay.io repository: den här kontrollen kommer från den officiella Toolkit, där Server Pro-imagen ligger i ett privat quay.io-register. Med SERVER_PRO=true hämtar Toolkit ghcr.io/ayaka-notes/overleaf-pro, som är offentlig, så ingen inloggning behövs. Ignorera den här varningen.
  • grep: /root/.docker/config.json: No such file or directory (eller en annan hemkatalog): quay.io-kontrollen letar efter quay.io i den filen. Docker skriver den bara när det finns inställningar att spara, till exempel efter docker login, så den saknas på många servrar. Den behövs inte.
  • perl: warning: Setting locale failed: Toolkit använder perl bara här, i bin/doctor, för att skriva ut dess version, och Perl varnar när LANG eller LC_ALL anger en locale som inte är installerad på värden. Versionen skrivs ändå ut. Om du vill tysta varningen anger du dessa variabler till en locale som listas av locale -a, till exempel C.UTF-8.
Varningar som Docker daemon is not running, docker not found, Docker Compose not found eller en saknad fil i config/ behöver däremot åtgärdas: Toolkit kan inte starta utan dem.
Senast ändrad 2 november 2026