Naar hoofdinhoud gaan

De Doctor

De Overleaf Toolkit wordt geleverd met een handig doctor-script dat helpt bij het debuggen. Voer bin/doctor uit en het script toont informatie over je hostomgeving, je configuratie en de afhankelijkheden die de Toolkit nodig heeft. Deze uitvoer kan ons ook helpen problemen met je Ayakaleaf Pro-installaties te diagnosticeren.
Gebruikers van Overleaf Pro kunnen een issue openen op GitHub.Het is een goed idee om de uitvoer van het script bin/doctor in je bericht op te nemen.

De Doctor raadplegen

Voer het doctor-script uit:
Run doctor
Je ziet uitvoer die lijkt op het onderstaande voorbeeld.

Hostinformatie

De sectie Host Information bevat informatie over de machine waarop de Toolkit draait (bijvoorbeeld de Linux-distributie en release).

Afhankelijkheden

De sectie Dependencies toont de tools die nodig zijn om de Toolkit te laten werken. Als een tool aanwezig is, wordt deze vermeld als status: present met versie-informatie. Als deze ontbreekt, wordt deze vermeld als status: MISSING! en wordt er onderaan de doctor-uitvoer een waarschuwing toegevoegd.
Als er afhankelijkheden ontbreken, werkt de Toolkit vrijwel zeker niet.

Configuratie

De sectie Configuration bevat informatie over bestanden in de map config/. Voor config/overleaf.rc toont de doctor enkele belangrijke waarden. Ontbrekende bestanden worden vermeld als status: MISSING! en er wordt onderaan de doctor-uitvoer een waarschuwing toegevoegd.
Opmerkingen bij het bovenstaande voorbeeld:
  • OVERLEAF_DATA_PATH ingesteld op /tmp/overleaf is mogelijk geen veilige locatie voor belangrijke gegevens.
  • MONGO_ENABLED: false betekent dat de Toolkit geen eigen MongoDB inricht; zorg er zo nodig voor dat MONGO_URL naar een extern beheerde MongoDB verwijst.
  • config/variables.env ontbreekt in het voorbeeld.

Waarschuwingen

De sectie Warnings vat de problemen samen die door het doctor-script zijn gevonden. Als er geen problemen zijn, wordt dat in deze sectie aangegeven.

Q&A

Antwoord: Nee, alle drie zijn informatief. bin/doctor drukt alleen een rapport af; het houdt bin/up niet tegen.
  • logged in to quay.io: false en de waarschuwing Server Pro enabled, but not logged in to quay.io repository: deze controle komt uit de officiële Toolkit, waar de Server Pro-image in een privéregistry op quay.io staat. Met SERVER_PRO=true haalt de Toolkit ghcr.io/ayaka-notes/overleaf-pro op, die openbaar is, dus inloggen is niet nodig. Negeer deze waarschuwing.
  • grep: /root/.docker/config.json: No such file or directory (of een andere thuismap): de quay.io-controle zoekt naar quay.io in dat bestand. Docker schrijft het alleen wanneer er instellingen op te slaan zijn, bijvoorbeeld na docker login, dus op veel servers ontbreekt het. Het is niet nodig.
  • perl: warning: Setting locale failed: de Toolkit gebruikt perl alleen hier, in bin/doctor, om de versie af te drukken, en Perl geeft een waarschuwing wanneer LANG of LC_ALL een locale noemt die niet op de host is geïnstalleerd. De versie wordt toch afgedrukt. Om de melding te onderdrukken, stel je deze variabelen in op een locale die door locale -a wordt vermeld, bijvoorbeeld C.UTF-8.
Waarschuwingen zoals Docker daemon is not running, docker not found, Docker Compose not found of een ontbrekend bestand in config/ moeten wel worden opgelost: zonder deze kan de Toolkit niet starten.
Laatst gewijzigd op 2 november 2026