Naar hoofdinhoud gaan
Sandbox-compilaties werken in de ontwikkelomgeving iets anders dan in de productie-image. De ontwikkelomgeving heeft ze al ingesteld; deze pagina legt de instellingen uit en drie dingen om op te letten:
  • Probleem met bestandsrechten
  • Gedeeld volume tussen history-v1 en filestore
  • Probleem met submappen

Sandbox-compilaties inschakelen

Sandbox-compilaties staan standaard aan. develop/docker-compose.yml zet SANDBOXED_COMPILES=true voor clsi, en develop/dev.env bevat de rest:
develop/dev.env
clsi haalt zelf geen images op, dus haal de images één keer op met docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (en :2025.1). LaTeX draait in de zustercontainers als TEXLIVE_IMAGE_USER. In de ontwikkelomgeving is dat tex, wat ook de standaard van clsi is (services/clsi/config/settings.defaults.cjs:154). De productie-image gebruikt in plaats daarvan www-data wanneer SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), omdat de bestanden daar worden aangemaakt door de gebruiker www-data van de Overleaf-container.
Gebruik niet uw zelfgebouwde image, anders kunt u op een reeks fouten stuiten.

Bestandsrechten herstellen

De clsi-container start als root, geeft de mappen compiles, output en cache aan de gebruiker node (uid 1000) en voert clsi daarna uit als node (services/clsi/entrypoint.sh). Daardoor is develop/compiles op de host van uid 1000, dezelfde uid als tex in de ontwikkelomgeving (zie de opmerking in develop/pandoc/Dockerfile). Met de bovenstaande instellingen compileert de ontwikkelomgeving zonder enige wijziging van rechten. Als je in plaats daarvan TEXLIVE_IMAGE_USER=root instelt, heeft root (uid 0) geen recht om naar de submappen van compiles te schrijven. Geef in dat geval de groep root eigendom en schrijfrechten op compiles, met setgid ingesteld zodat nieuwe submappen dit eigendom erven:
bash
Uitgebreide documentatie vindt u in services/clsi/README.md.

Gedeeld volume tussen history-v1 en filestore

De instellingen in deze en de volgende sectie staan al in develop/docker-compose.yml en develop/dev.env. Ze zijn alleen van belang met S3_ENABLED=false in develop/dev.rc. Met de standaardwaarde S3_ENABLED=true bewaren filestore en history-v1 deze bestanden in plaats daarvan in RustFS-buckets (develop/s3/docker-compose.yml).
Standaard fungeert filestore als brug tussen S3 en andere services in Overleaf. In Overleaf CE of Server Pro worden alle bestanden echter standaard lokaal opgeslagen. Daarom heeft Overleaf een zeer slimme methode geïntroduceerd.
server-ce/config/settings.js
Tegelijkertijd wordt data/history ook door de history-service gebruikt. Zo kunnen verschillende microservices dezelfde gegevens delen. Daarom koppelt de filestore-service in develop het volume history-v1-buckets van history-v1. Zonder dit volume kan clsi geen blobbestanden ophalen bij de filestore-service.
develop/docker-compose.yml
filestore vindt de buckets via deze instellingen in dev.env:
develop/dev.env

Submappen gebruiken

filestore leest history-blobs altijd met submappen (services/filestore/app/js/KeyBuilder.js:58, :70). De productie-image zet useSubdirectories aan voor history-v1 (server-ce/config/production.json), maar de standaardconfiguratie van history-v1 niet, dus in ontwikkeling zou history-v1 alle gegevens plat opslaan. Daarom zet dev.env NODE_CONFIG voor history-v1:
develop/dev.env
Zonder deze instelling slaat history-v1 de project_blobs-bestanden zo op:
Met useSubdirectories op true wordt de _ in deze namen een /, zodat elke blob in submappen wordt opgeslagen.
Laatst gewijzigd op 20 november 2026