Saltar al contenido principal
Las compilaciones en sandbox funcionan un poco distinto en el entorno de desarrollo que en la imagen de producción. El entorno de desarrollo ya las tiene configuradas; esta página explica la configuración y tres cosas que hay que tener en cuenta:
  • 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
clsi no descarga imágenes por sí mismo, así que descárgalas una vez con 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.
No uses tu propia imagen compilada; podrías encontrarte con una serie de errores.

Corregir los permisos de archivos

El contenedor de clsi arranca como root, asigna las carpetas compiles, 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
Para obtener documentación detallada, consulta 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).
De forma predeterminada, filestore actúa como puente entre S3 y los demás servicios de Overleaf. Sin embargo, en Overleaf CE o Server Pro, todos los archivos se almacenan localmente de forma predeterminada. Por ello, Overleaf introdujo un método muy ingenioso.
server-ce/config/settings.js
Al mismo tiempo, 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
filestore encuentra los buckets mediante esta configuración en 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
Sin ello, history-v1 guarda los archivos de project_blobs así:
Con useSubdirectories en true, el _ de estos nombres se convierte en /, de modo que cada blob se guarda en subcarpetas.
Última modificación el 20 de noviembre de 2026