Passer au contenu principal
Les compilations en sandbox fonctionnent un peu différemment dans l’environnement de développement que dans l’image de production. L’environnement de développement les a déjà configurées ; cette page explique les paramètres et trois points à garder à l’esprit :
  • Problème de permissions de fichiers
  • Partage de volume entre history-v1 et filestore
  • Problème des sous-répertoires

Activer les compilations en sandbox

Les compilations en sandbox sont activées par défaut. develop/docker-compose.yml définit SANDBOXED_COMPILES=true pour clsi, et develop/dev.env contient le reste :
develop/dev.env
clsi ne récupère pas les images lui-même, alors récupérez-les une fois avec docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (et :2025.1). LaTeX s’exécute dans les conteneurs frères sous TEXLIVE_IMAGE_USER. Dans l’environnement de développement, il s’agit de tex, qui est aussi la valeur par défaut de clsi (services/clsi/config/settings.defaults.cjs:154). L’image de production utilise www-data à la place lorsque SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), car les fichiers y sont créés par l’utilisateur www-data du conteneur Overleaf.
N’utilisez pas votre propre image construite localement, vous risqueriez de rencontrer une série d’erreurs.

Corriger les permissions de fichiers

Le conteneur clsi démarre en root, attribue les dossiers compiles, output et cache à l’utilisateur node (uid 1000), puis exécute clsi en tant que node (services/clsi/entrypoint.sh). Ainsi, develop/compiles sur l’hôte appartient à l’uid 1000, le même uid que tex dans l’environnement de développement (voir le commentaire dans develop/pandoc/Dockerfile). Avec les paramètres ci-dessus, l’environnement de développement compile sans aucune modification des permissions. Si vous définissez plutôt TEXLIVE_IMAGE_USER=root, root (uid 0) n’a pas la permission d’écrire dans les sous-dossiers de compiles. Dans ce cas, donnez au groupe root la propriété et le droit d’écriture sur compiles, avec setgid activé pour que les nouveaux sous-dossiers héritent de cette propriété :
bash
Pour une documentation détaillée, consultez services/clsi/README.md.

Partage de volume entre history-v1 et filestore

Les paramètres de cette section et de la suivante figurent déjà dans develop/docker-compose.yml et develop/dev.env. Ils ne comptent qu’avec S3_ENABLED=false dans develop/dev.rc. Avec la valeur par défaut S3_ENABLED=true, filestore et history-v1 conservent plutôt ces fichiers dans des buckets RustFS (develop/s3/docker-compose.yml).
Par défaut, filestore sert de passerelle entre S3 et les autres services d’Overleaf. Cependant, dans Overleaf CE ou Server Pro, tous les fichiers sont stockés localement par défaut. Overleaf a donc introduit une méthode assez astucieuse.
server-ce/config/settings.js
Parallèlement, data/history est aussi utilisé par le service d’historique. Ainsi, différents microservices peuvent partager les mêmes données. C’est pourquoi le service filestore de develop monte le volume history-v1-buckets de history-v1. Sans lui, clsi ne pourra pas récupérer les fichiers blob depuis le service filestore.
develop/docker-compose.yml
filestore trouve les buckets grâce à ces paramètres de dev.env :
develop/dev.env

Utiliser les sous-répertoires

filestore lit toujours les blobs d’historique avec des sous-répertoires (services/filestore/app/js/KeyBuilder.js:58, :70). L’image de production active useSubdirectories pour history-v1 (server-ce/config/production.json), mais pas la configuration par défaut de history-v1, donc en développement history-v1 aplatirait toutes les données. dev.env définit donc NODE_CONFIG pour history-v1 :
develop/dev.env
Sans cela, history-v1 stocke les fichiers project_blobs ainsi :
Avec useSubdirectories défini à true, le _ de ces noms devient /, de sorte que chaque blob est stocké dans des sous-dossiers.
Dernière modification le 20 novembre 2026