- Problema de permisos de archivos
- Volumen compartido entre history-v1 y filestore
- Problema de subdirectorios
Habilitar compilaciones en sandbox
Las compilaciones en sandbox están activadas por defecto.develop/docker-compose.yml establece SANDBOXED_COMPILES=true para clsi, y develop/dev.env contiene el resto:
develop/dev.env
docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (y :2025.1).
LaTeX se ejecuta en los contenedores hermanos como TEXLIVE_IMAGE_USER. En el entorno de desarrollo es tex, que también es el valor por defecto de clsi (services/clsi/config/settings.defaults.cjs:154). La imagen de producción usa www-data en su lugar cuando SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), porque allí los archivos los crea el usuario www-data del contenedor de Overleaf.
Corregir los permisos de archivos
El contenedor de clsi arranca como root, asigna las carpetascompiles, output y cache al usuario node (uid 1000) y luego ejecuta clsi como node (services/clsi/entrypoint.sh). Por eso develop/compiles en el host pertenece al uid 1000, el mismo uid que tex en el entorno de desarrollo (consulta el comentario en develop/pandoc/Dockerfile). Con la configuración anterior, el entorno de desarrollo compila sin ningún cambio de permisos.
Si en cambio estableces TEXLIVE_IMAGE_USER=root, root (uid 0) no tiene permiso para escribir en las subcarpetas de compiles. En ese caso, da al grupo root la propiedad y permiso de escritura sobre compiles, con setgid activado para que las nuevas subcarpetas hereden esta propiedad:
bash
services/clsi/README.md.
Volumen compartido entre history-v1 y filestore
La configuración de esta sección y de la siguiente ya está en
develop/docker-compose.yml y develop/dev.env. Solo importa con S3_ENABLED=false en develop/dev.rc. Con el valor por defecto S3_ENABLED=true, filestore e history-v1 guardan estos archivos en buckets de RustFS (develop/s3/docker-compose.yml).server-ce/config/settings.js
data/history también lo usa el servicio de historial. De este modo, distintos microservicios pueden compartir los mismos datos. Por eso el servicio filestore en develop monta el volumen history-v1-buckets de history-v1. Sin él, clsi no podrá obtener los archivos blob del servicio filestore.
develop/docker-compose.yml
dev.env:
develop/dev.env
Usar subdirectorios
filestore siempre lee los blobs del historial con subdirectorios (services/filestore/app/js/KeyBuilder.js:58, :70). La imagen de producción activa useSubdirectories para history-v1 (server-ce/config/production.json), pero la configuración por defecto de history-v1 no, así que en desarrollo history-v1 aplanaría todos los datos. Por eso dev.env establece NODE_CONFIG para history-v1:
develop/dev.env
project_blobs así:
useSubdirectories en true, el _ de estos nombres se convierte en /, de modo que cada blob se guarda en subcarpetas.
