Saltar para o conteúdo principal
O Ayakaleaf Pro é um substituto direto da Overleaf Community Edition oficial, distribuído como uma imagem Docker.

Escolha seu caminho de instalação

Instalar no Linux

Usando o Docker Compose no Linux (com Docker)

Instalar no Windows

Usando o Docker Compose no Windows (com WSL)

Instalar no Mac

Usando o Docker Compose no macOS (Docker Desktop)

Executar em um cluster Kubernetes

Usando o Kubernetes (experimental)

Executar em um servidor bem pequeno

Somente para servidores pequenos (requer 2 GB de swap)

Deixar o Claude ou o Codex fazer a instalação

Usando o Claude ou o Codex

Experimentar rapidamente no navegador

Usando o GitHub Codespace (TeX Live mínimo)

Migrar um Overleaf existente

Migrar de uma instância Overleaf existente

Instalar sem acesso à internet

Implantações isoladas/offline para uso interno
Vindo do Overleaf Server Pro oficial? (Qual é a diferença?) Abra uma issue antes de migrar: os templates são armazenados de forma diferente, e ajudaremos você gratuitamente.
Quer voltar para a Overleaf Community Edition oficial? Defina SERVER_PRO=false (Toolkit da ayaka-notes) ou remova o arquivo de override (Toolkit oficial). Nenhum dado é perdido.

Requisitos de hardware

Realizamos testes e constatamos que, se você executar o Overleaf em um servidor com 2 núcleos e 2 GB de RAM, seus componentes principais — baseados principalmente em Node.js — consumirão aproximadamente 1 GB de memória. O Redis e o MongoDB podem exigir mais 0,5 GB, enquanto iniciar um contêiner Docker isolado para compilação pode consumir outros 0,3 GB. Isso significa que um servidor com 2 núcleos e 2 GB, na prática, consegue lidar com apenas cerca de uma compilação simultânea por vez.
  • Os requisitos mínimos de hardware para instalar o Ayakaleaf Pro são uma CPU de 2 núcleos e 3 GB de RAM.
  • Devido ao tamanho da nossa imagem do TeX Live, são necessários pelo menos 40 GB de armazenamento para habilitar a compilação em sandbox.
  • Se você quiser instalar o conjunto completo de imagens do TeX Live de 2020 a 2026, certifique-se de ter pelo menos 150 GB de espaço livre em disco.
Aqui estão algumas configurações de hardware recomendadas para diferentes cenários de uso:

Requisitos de software

Quanto aos requisitos de software, recomendamos usar uma versão recente e estável do Ubuntu (por exemplo, Ubuntu 24.04 em 2025–2026, Ubuntu 22.04 em 2023–2024) junto com a versão estável mais recente do Docker.
O Ubuntu 26.04 vem com o kernel Linux 7.0, e o MongoDB se recusa a iniciar nos kernels Linux 6.19 a 7.0.13 (detalhes). Para executar nesses kernels, adicione o seguinte ao serviço mongo em overleaf-toolkit/config/docker-compose.override.yml (o mesmo arquivo que define a imagem do Ayakaleaf Pro). Nosso CI roda no Ubuntu 26.04 com essa configuração. O kernel 7.0.14 e posteriores não precisam dela.
docker-compose.override.yml
Recomendamos o Linux para servidores compartilhados e de produção. Você também pode executar o Ayakaleaf Pro no macOS ou no Windows com WSL 2 usando o Docker Desktop. Siga o guia da sua plataforma. As imagens oferecem suporte a AMD64 e ARM64.

Desempenho do LaTeX

O LaTeX é um programa single-thread, o que significa que ele só consegue utilizar um núcleo de CPU por vez. Ao compilar um único documento, o desempenho é limitado principalmente pela frequência de clock de núcleo único da CPU. Portanto, quanto maior o desempenho de núcleo único da sua CPU, mais rápido você conseguirá compilar um documento. Mais núcleos de CPU só trazem benefícios quando vários usuários estão compilando documentos simultaneamente. Usando o template ThuThesis como exemplo, o tempo de compilação é de cerca de 6 segundos em um Intel Core i9-14900K (5,6 GHz), enquanto leva cerca de 13 segundos em uma instância Azure Standard D2as v5 (2 vCPUs, 8 GiB de RAM) equipada com um AMD EPYC 7763 (3,2 GHz). É claro que o desempenho real de compilação depende da sua configuração de hardware. A maioria das CPUs de servidor não opera em frequências tão altas quanto o 14900K, então você precisará encontrar um equilíbrio entre custo e velocidade de compilação. Além disso, também realizamos uma análise aprofundada do desempenho de compilação do LaTeX. Se tiver interesse, consulte nosso blog Overleaf Benchmark: A Deep Research of Concurrent LaTeX Compilation in Overleaf (SaaS and Self-host).
Última modificação em 21 de novembro de 2026