Saltar para o conteúdo principal
As compilações em sandbox funcionam um pouco diferente no ambiente de desenvolvimento do que na imagem de produção. O ambiente de desenvolvimento já as tem configuradas; esta página explica as configurações e três pontos a ter em mente:
  • Problema de permissões de arquivos
  • Compartilhamento de volume entre history-v1 e filestore
  • Problema de subdiretórios

Habilitar o Sandbox Compiles

As compilações em sandbox vêm ativadas por padrão. develop/docker-compose.yml define SANDBOXED_COMPILES=true para o clsi, e develop/dev.env contém o restante:
develop/dev.env
O clsi não baixa imagens sozinho, então baixe as imagens uma vez com docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (e :2025.1). O LaTeX roda nos contêineres irmãos como TEXLIVE_IMAGE_USER. No ambiente de desenvolvimento, esse usuário é tex, que também é o padrão do clsi (services/clsi/config/settings.defaults.cjs:154). A imagem de produção usa www-data quando SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), porque lá os arquivos são criados pelo usuário www-data do contêiner do Overleaf.
Não use uma imagem construída por você mesmo, pois você pode encontrar uma série de erros.

Corrigir permissões de arquivos

O contêiner do clsi inicia como root, entrega as pastas compiles, output e cache ao usuário node (uid 1000) e então executa o clsi como node (services/clsi/entrypoint.sh). Assim, develop/compiles no host pertence ao uid 1000, o mesmo uid de tex no ambiente de desenvolvimento (veja o comentário em develop/pandoc/Dockerfile). Com as configurações acima, o ambiente de desenvolvimento compila sem nenhuma alteração de permissão. Se, em vez disso, você definir TEXLIVE_IMAGE_USER=root, o root (uid 0) não tem permissão para escrever nas subpastas de compiles. Nesse caso, dê ao grupo root a propriedade e permissão de escrita em compiles, com setgid definido para que as novas subpastas herdem essa propriedade:
bash
Para a documentação detalhada, consulte services/clsi/README.md.

Compartilhamento de volume entre history-v1 e filestore

As configurações desta seção e da próxima já estão em develop/docker-compose.yml e develop/dev.env. Elas só importam com S3_ENABLED=false em develop/dev.rc. Com o padrão S3_ENABLED=true, o filestore e o history-v1 guardam esses arquivos em buckets do RustFS (develop/s3/docker-compose.yml).
Por padrão, o filestore atua como uma ponte entre o S3 e os outros serviços do Overleaf. No entanto, no Overleaf CE ou no Server Pro, todos os arquivos são armazenados localmente por padrão. Por isso, o Overleaf introduziu um método bastante engenhoso.
server-ce/config/settings.js
Ao mesmo tempo, data/history também é usado pelo serviço de histórico. Dessa forma, microsserviços diferentes podem compartilhar os mesmos dados. Por isso o serviço filestore em develop monta o volume history-v1-buckets do history-v1. Sem ele, o clsi não conseguirá obter arquivos blob do serviço filestore.
develop/docker-compose.yml
O filestore encontra os buckets por meio destas configurações em dev.env:
develop/dev.env

Usar subdiretórios

O filestore sempre lê os blobs do histórico com subdiretórios (services/filestore/app/js/KeyBuilder.js:58, :70). A imagem de produção ativa useSubdirectories para o history-v1 (server-ce/config/production.json), mas a configuração padrão do history-v1 não, então em desenvolvimento o history-v1 achataria todos os dados. Por isso o dev.env define NODE_CONFIG para o history-v1:
develop/dev.env
Sem isso, o history-v1 armazena os arquivos de project_blobs assim:
Com useSubdirectories definido como true, o _ nesses nomes vira /, então cada blob é armazenado em subpastas.
Última modificação em 20 de novembro de 2026