Naar hoofdinhoud gaan
Deze optionele services zijn niet nodig om Overleaf te draaien, maar helpen veel bij het ontwikkelen, debuggen en onderzoeken van de gegevens. Ze maken allemaal deel uit van de ontwikkelomgeving, dus er hoeft niets aan docker-compose.yml te worden toegevoegd. Zodra je bent ingelogd op de site, linkt het menu Dev tools in de navigatiebalk naar de tools die de site op eigen paden aanbiedt.
Geen van deze tools heeft een login: de anonieme gebruikers van Grafana zijn de beheerders, en Mongo Express kan elk document wijzigen. De site, Hoppscotch, Mongo Express (8081) en RedisInsight (5540) luisteren alleen op 127.0.0.1 van de host, dus andere hosts kunnen ze niet bereiken.

Grafana

Grafana wordt door de site aangeboden op /grafana/, via webpack-dev-server, en heeft dus geen eigen poort nodig. De map Overleaf Develop bevat deze dashboards:

All services: de status van elke service, de host en de resources die elke service gebruikt

Data flow: een bewerking op weg van document-updater via project-history naar history-v1 en Mongo

Prometheus haalt /metrics op van de services, mongodb-exporter, redis-exporter, cadvisor en node-exporter; Alloy stuurt de logs van elke container van het project naar Loki, waar de filters Log search, Service en Log level van de dashboards ze lezen. Hun gegevens staan alleen in de containers, dus opnieuw aanmaken maakt ze leeg. cAdvisor draait geprivilegieerd en leest /, /sys, de Docker-gegevens en de containerd-socket van de host, alleen-lezen; node-exporter leest / van de host. De dashboards worden gegenereerd: wijzig develop/grafana/make-dashboards en voer het uit, in plaats van de JSON-bestanden te bewerken.

Mailpit

Met MAILPIT_ENABLED=true stuurt web elke e-mail naar Mailpit in plaats van naar een echte mailserver, en staat e-mailbevestiging aan (EMAIL_CONFIRMATION_DISABLED=false). Activatielinks, projectuitnodigingen, wachtwoordresets en bevestigingscodes kun je dan vanuit de inbox volgen.

Een activatiemail, een projectuitnodiging, een bevestigingscode en een wachtwoordreset in Mailpit

Mailpit heeft geen volume: als de container opnieuw wordt aangemaakt, is de inbox leeg.

Mongo Express

Mongo Express toont de collecties van de database sharelatex en kan de documenten bekijken, bewerken, importeren en exporteren.

De collecties van de database sharelatex in Mongo Express

RedisInsight

RedisInsight bewaart zijn verbindingen in develop/data/redis-insight. Kies de eerste keer Connect existing database en vul host redis en poort 6379 in.

RedisInsight verbonden met de service redis

Hoppscotch instellen

API-verzoeken via proxy

Hoppscotch verstuurt verzoeken vanuit de browser, die de services niet via hun Docker-namen kan bereiken. De proxy, Proxyscotch, draait binnen het Docker-netwerk en wordt aangeboden op /proxy van het Hoppscotch-adres. Open http://localhost:9170, ga naar Settings → Interceptor, kies Proxy en stel de Proxy URL in op http://localhost:9170/proxy. De instelling blijft in de browser bewaard.

De Interceptor-instelling. De screenshot komt uit een oudere opstelling: gebruik http://localhost:9170/proxy als Proxy URL.

Nu kun je met http://web:3000/status testen of web actief is:

De service-API’s importeren

develop/hoppscotch/openapi/ bevat een OpenAPI-bestand voor de interne API van elke service. Open in Hoppscotch Collections → Import → Import from File en selecteer alle bestanden tegelijk. Elk bestand wordt een collectie waarvan de verzoeken naar het Docker-adres van de service gaan. Dezelfde bestanden worden getoond in de sectie Service-API.

CSRF-problemen

Als je Postman of andere debugtools gebruikt om een POST-verzoek te versturen, kan het gebeuren dat het inloggen geweigerd wordt, met een 403-fout als gevolg. Dat komt doordat Overleaf beveiligd is met CSRF-verificatie.
In je console zie je mogelijk:
Om dit tijdens je Overleaf-ontwikkeling op te lossen, moet je je CSRF-token instellen. Hieronder volgt een gedetailleerde handleiding.
1

Pre-request toevoegen

Voeg de volgende code toe aan Pre-Request
Het script ziet er als volgt uit:
2

Request-headers toevoegen

Je moet de volgende headers toevoegen:
3

Inloggen met API-tools

Nu kun je inloggen met je gebruikersnaam en wachtwoord.
Hieronder zie je het antwoord wanneer je een verkeerde gebruikersnaam of een verkeerd wachtwoord invoert.
Laatst gewijzigd op 20 november 2026