Saltar para o conteúdo principal
Se você estiver usando uma versão anterior, use sharelatex em vez de overleaf nos nomes de caminhos.
Montar um sistema de arquivos NFS em um contêiner do Overleaf é tecnicamente possível, mas não é recomendado e pode resultar em diferentes tipos de erros de desempenho.Um erro comum observado nas compilações é:
Em particular, desaconselhamos o uso de sistemas de arquivos baseados em NFS para dados efêmeros, como os diretórios usados para dados de compilação. Recomendamos usar um disco temporário local, de preferência um SSD local, para os diretórios a seguir.Em configurações baseadas em docker-compose, sugerimos simplesmente substituir o bind-mount do NFS, o que evita alterar caminhos na aplicação. Aqui está um trecho de exemplo de configuração do docker-compose usando um disco temporário montado em /scratch:
docker-compose excerpt
Não é necessário migrar nenhum arquivo existente do NFS para o novo local após a atualização. O compilador LaTeX pode recriar todos os arquivos com uma nova compilação completa.Para mais detalhes, consulte: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
Se você estiver executando o Overleaf no Windows ou macOS, o serviço mongo pode falhar ao reiniciar, com o erro:
Example error
Isso pode ocorrer quando os dados do MongoDB são montados via bind mount a partir de um sistema de arquivos que não oferece a semântica exigida, como um diretório montado do Windows. Para o Windows com WSL 2, mantenha o Toolkit no diretório pessoal Linux do Ubuntu e use os bind mounts padrão. Consulte as verificações do MongoDB do guia da plataforma.Para uma nova instalação que precise de armazenamento gerenciado pelo Docker, o override a seguir usa volumes nomeados (consulte as orientações de armazenamento da imagem do MongoDB). Em uma instalação existente, alterar as montagens não migra os dados: faça backup e restaure o banco de dados/cache antes de trocar, ou o serviço verá volumes vazios. Adicione isto ao config/docker-compose.override.yml, mesclando com qualquer configuração existente:
config/docker-compose.override.yml
Para mais informações, consulte: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
Use o comando docker logs redis para obter uma cópia dos logs.Se você vir a linha Fatal: Can't initialize Background Jobs, a saída completa será semelhante a esta:
Redis log example
Isso pode estar relacionado à versão do Docker em uso. Atualizar para uma versão >= 20.10.10 deve resolver o problema.Para mais informações, consulte o issue do Redis upstream: https://github.com/redis/redis/issues/12362Referência: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop
Ocasionalmente, as imagens de pré-visualização/miniatura geradas pelo Ayakaleaf Pro podem ser criadas na orientação errada e exigir intervenção manual para correção. Essas imagens são armazenadas em /var/lib/overleaf/data/template_files/.Recomendamos fazer backup desta pasta antes de fazer qualquer alteração.Você precisará seguir as etapas abaixo para cada modelo afetado:Encontre o ID do modeloNavegue até a galeria de modelos da sua instância (/templates/all), abra um modelo afetado e copie o ID da URL (por exemplo: https://your-instance-url/templates/6645d346c224815e9460a695).Execute o comando de correçãoExecute o seguinte comando a partir do host Docker (substitua o ID do modelo pelo que você copiou e atualize o caminho, se necessário):docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”Referência: https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images
O comando \write18 é desabilitado por padrão no Community Edition porque todas as compilações acontecem dentro do mesmo contêiner sharelatex; esse é o padrão mais seguro.Se quiser habilitá-lo para o pdflatex, crie um arquivo latexmkrc na raiz do seu projeto com o seguinte conteúdo:
latexmkrc
Em seguida, tente recompilar.Referência: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
Esses erros significam que o contêiner mongo continua travando e reiniciando. O bin/up inicia o MongoDB e depois executa um comando dentro dele, que falha enquanto o contêiner reinicia. bin/docker-compose ps mostra o serviço mongo como Restarting.Para descobrir a causa real, leia o log do MongoDB:
As causas comuns são:
  • A CPU não tem suporte a AVX. O MongoDB 5.0 e posteriores precisam de AVX em x86-64, e o log mostra MongoDB 5.0+ requires a CPU with AVX support. Em uma máquina virtual, defina o tipo de CPU como host para que o AVX seja repassado.
  • Kernel Linux 6.19 a 7.0.13. O MongoDB se recusa a iniciar nesses kernels. Consulte Requisitos de software para a solução alternativa.
  • Os dados foram criados por uma versão mais antiga do MongoDB. O MongoDB 8.0 não consegue abrir diretamente dados da 4.4 ou da 5.0. Atualize uma versão principal de cada vez; consulte Atualizar o MongoDB.
Isso é esperado com o Ayakaleaf Pro e pode ser ignorado. A mensagem é exibida quando OVERLEAF_IS_SERVER_PRO não é true, o que é o caso na imagem do Ayakaleaf Pro. O Ayakaleaf Pro não precisa dessa variável, então deixe-a sem definir.
Antes de o Overleaf iniciar, o contêiner executa verificações de inicialização e é encerrado quando uma delas falha. O Toolkit o executa com restart: always, então o Docker o inicia novamente e a mesma verificação falha outra vez. A saída de inicialização indica a verificação que falhou:
As causas mais comuns são:
  • Missing required secrets: defina OVERLEAF_INVITE_TOKEN_SECRET em config/variables.env; consulte Variáveis de ambiente.
  • ShareLaTeX to Overleaf rebranding: a configuração ainda usa variáveis ou caminhos SHARELATEX_; renomeie-os conforme indicado na mensagem.
  • Um erro após Checking can connect to mongo and redis: o Overleaf não consegue acessar o MongoDB ou o Redis. Verifique bin/logs mongo e bin/logs redis.
Depois de corrigir a causa, execute bin/up -d.
A cada inicialização, o contêiner executa seus scripts de inicialização um após o outro, e o log nomeia cada um como *** Running /etc/my_init.d/<script>.... 910_initiate_doc_version_recovery só tem trabalho a fazer em instâncias que já executaram o Overleaf 5.0.1. Em qualquer outra instância, ele exibe No recovery of doc versions needed. e a inicialização continua. Sua saída também vai para data/history/doc-version-recovery.log em OVERLEAF_DATA_PATH.O código de saída e o final de bin/docker-compose logs --tail=100 sharelatex indicam o que aconteceu:
  • Código de saída 2, e o log termina com *** Init system aborted.: o contêiner foi parado, por exemplo por bin/stop, docker stop ou Ctrl+C no bin/up. O script da última linha Running é apenas o que estava em execução naquele momento; ele não falhou. Inicie o contêiner novamente com bin/up -d e deixe a inicialização terminar.
  • Código de saída 1, e o log mostra *** /etc/my_init.d/<script> failed with status <n>: esse script falhou, e o erro dele está nas linhas logo acima. Se 910_initiate_doc_version_recovery falhou com Detected unflushed changes while recovering doc versions, a instância executou a 5.0.1 e ainda tem edições não descarregadas; siga o guia oficial de Doc version recovery.
Esta página é exibida quando a sua conta está conectada, mas não tem permissão para abrir a página, por exemplo uma página de administração aberta por uma conta que não é administradora, ou um projeto que não foi compartilhado com você.Para abrir as páginas de administração, faça login com uma conta de administrador. Um administrador existente pode tornar outra conta administradora, ou você pode criar uma com o comando create-user --admin; consulte Gerenciamento de usuários. No ambiente de desenvolvimento (develop/), as páginas de administração também exigem ADMIN_PRIVILEGE_AVAILABLE=true em develop/dev.env; a imagem do Ayakaleaf Pro já a define.
Última modificação em 8 de novembro de 2026