Hopp til hovedinnhold
Sandkassekompileringer fungerer litt annerledes i utviklingsmiljøet enn i produksjonsimaget. Utviklingsmiljøet har dem allerede satt opp; denne siden forklarer innstillingene og tre ting du bør være oppmerksom på:
  • Problem med filtillatelser
  • Delt volum mellom history-v1 og filestore
  • Problem med underkataloger

Aktiver Sandbox Compiles

Sandkassekompileringer er på som standard. develop/docker-compose.yml setter SANDBOXED_COMPILES=true for clsi, og develop/dev.env inneholder 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 kjører i søskencontainerne som TEXLIVE_IMAGE_USER. I utviklingsmiljøet er dette tex, som også er standard for clsi (services/clsi/config/settings.defaults.cjs:154). Produksjonsimaget bruker i stedet www-data når SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), fordi filene der opprettes av brukeren www-data i Overleaf-containeren.
Ikke bruk et image du har bygget selv, da kan du støte på en rekke feil.

Rett opp filtillatelser

clsi-containeren starter som root, gir mappene compiles, output og cache til brukeren node (uid 1000) og kjører deretter clsi som node (services/clsi/entrypoint.sh). Derfor tilhører develop/compiles på verten uid 1000, samme uid som tex i utviklingsmiljøet (se kommentaren i develop/pandoc/Dockerfile). Med innstillingene over kompilerer utviklingsmiljøet uten noen endring av tillatelser. Hvis du i stedet setter TEXLIVE_IMAGE_USER=root, har root (uid 0) ikke tillatelse til å skrive til undermappene i compiles. Gi i så fall gruppen root eierskap og skrivetilgang til compiles, med setgid satt slik at nye undermapper arver dette eierskapet:
bash
For mer detaljert dokumentasjon, se services/clsi/README.md.

Delt volum mellom history-v1 og filestore

Innstillingene i denne og neste del finnes allerede i develop/docker-compose.yml og develop/dev.env. De har bare betydning med S3_ENABLED=false i develop/dev.rc. Med standardverdien S3_ENABLED=true lagrer filestore og history-v1 i stedet disse filene i RustFS-buckets (develop/s3/docker-compose.yml).
Som standard fungerer filestore som en bro mellom S3 og andre tjenester i Overleaf. I Overleaf CE eller Server Pro lagres imidlertid alle filer lokalt som standard. Derfor har Overleaf innført en ganske innviklet metode.
server-ce/config/settings.js
Samtidig brukes data/history også av historikktjenesten. På denne måten kan ulike mikrotjenester dele de samme dataene. Derfor monterer filestore-tjenesten i develop volumet history-v1-buckets fra history-v1. Uten det kan ikke clsi hente blob-filer fra filestore-tjenesten.
develop/docker-compose.yml
filestore finner bucketene gjennom disse innstillingene i dev.env:
develop/dev.env

Bruk underkataloger

filestore leser alltid historikkblobber med underkataloger (services/filestore/app/js/KeyBuilder.js:58, :70). Produksjonsimaget slår på useSubdirectories for history-v1 (server-ce/config/production.json), men standardkonfigurasjonen til history-v1 gjør det ikke, så i utvikling ville history-v1 flate ut alle dataene. Derfor setter dev.env NODE_CONFIG for history-v1:
develop/dev.env
Uten den lagrer history-v1 project_blobs-filene slik:
Når useSubdirectories er satt til true, blir _ i disse navnene til /, slik at hver blob lagres i undermapper.
Sist endret 20. november 2026