Spring til hovedindhold
Sandkassekompileringer fungerer lidt anderledes i udviklingsmiljøet end i produktionsimaget. Udviklingsmiljøet har dem allerede sat op; denne side forklarer indstillingerne og tre ting, du skal være opmærksom på:
  • Problem med filrettigheder
  • Delt volume mellem history-v1 og filestore
  • Problem med undermapper

Aktivér Sandbox Compiles

Sandkassekompileringer er slået til som standard. develop/docker-compose.yml sætter SANDBOXED_COMPILES=true for clsi, og develop/dev.env indeholder resten:
develop/dev.env
clsi henter ikke images selv, så hent imagene én gang med docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (og :2025.1). LaTeX kører i søskendecontainerne som TEXLIVE_IMAGE_USER. I udviklingsmiljøet er det tex, som også er clsis standard (services/clsi/config/settings.defaults.cjs:154). Produktionsimaget bruger i stedet www-data, når SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), fordi filerne dér oprettes af brugeren www-data i Overleaf-containeren.
Brug venligst ikke dit eget byggede image, da du kan støde på en række fejl.

Ret filrettigheder

clsi-containeren starter som root, giver mapperne compiles, output og cache til brugeren node (uid 1000) og kører derefter clsi som node (services/clsi/entrypoint.sh). Derfor tilhører develop/compiles på værten uid 1000, samme uid som tex i udviklingsmiljøet (se kommentaren i develop/pandoc/Dockerfile). Med indstillingerne ovenfor kompilerer udviklingsmiljøet uden nogen ændring af rettigheder. Hvis du i stedet sætter TEXLIVE_IMAGE_USER=root, har root (uid 0) ikke tilladelse til at skrive til undermapperne i compiles. Giv i så fald gruppen root ejerskab og skriverettighed til compiles, med setgid sat, så nye undermapper arver dette ejerskab:
bash
For detaljeret dokumentation kan du se services/clsi/README.md.

Delt volume mellem history-v1 og filestore

Indstillingerne i dette og det næste afsnit findes allerede i develop/docker-compose.yml og develop/dev.env. De har kun betydning med S3_ENABLED=false i develop/dev.rc. Med standardværdien S3_ENABLED=true gemmer filestore og history-v1 i stedet disse filer i RustFS-buckets (develop/s3/docker-compose.yml).
Som standard fungerer filestore som en bro mellem S3 og andre tjenester i Overleaf. I Overleaf CE eller Server Pro gemmes alle filer dog lokalt som standard. Derfor har Overleaf indført en meget snedig metode.
server-ce/config/settings.js
Samtidig bruges data/history også af historiktjenesten. På den måde kan forskellige mikrotjenester dele de samme data. Derfor monterer filestore-tjenesten i develop volumet history-v1-buckets fra history-v1. Uden det kan clsi ikke hente blob-filer fra filestore-tjenesten.
develop/docker-compose.yml
filestore finder bucketsene via disse indstillinger i dev.env:
develop/dev.env

Brug undermapper

filestore læser altid historikblobs med undermapper (services/filestore/app/js/KeyBuilder.js:58, :70). Produktionsimaget slår useSubdirectories til for history-v1 (server-ce/config/production.json), men det gør standardkonfigurationen af history-v1 ikke, så i udvikling ville history-v1 gøre alle data flade. Derfor sætter dev.env NODE_CONFIG for history-v1:
develop/dev.env
Uden den gemmer history-v1 project_blobs-filerne sådan her:
Med useSubdirectories sat til true bliver _ i disse navne til /, så hver blob gemmes i undermapper.
Sidst ændret 20. november 2026