Saltar para o conteúdo principal
Aqui reunimos as respostas a algumas perguntas frequentes sobre o Ayakaleaf Pro.

Perguntas básicas

Não. O Ayakaleaf Pro é totalmente gratuito. Não é uma versão de avaliação e não exige licença.
Sim. O Ayakaleaf Pro inclui todos os recursos do Overleaf Server Pro, incluindo a integração com o Git-Bridge. Ele também inclui recursos selecionados da plataforma SaaS do Overleaf. Continuamos a desenvolver e a aprimorar o Ayakaleaf Pro.
O Overleaf Server Pro custa cerca de $300 por usuário por ano. São necessárias pelo menos 10 licenças, portanto as implantações começam em aproximadamente $3.000 por ano. Contratos públicos menores nos EUA mostram custos anuais de cerca de $320–$370 por usuário. Isso torna o Server Pro caro, especialmente para equipes menores. Consulte #information-and-price-about-overleaf-server-pro para ver compras e preços documentados.
O Overleaf Server Pro é amplamente usado por organizações governamentais. Elas o implantam em redes privadas e controlam rigorosamente o acesso. Para proteger dados sensíveis, os recursos incluídos evitam trocar dados com serviços de terceiros. Se você precisar de sincronização com o GitHub, IA ou recursos conectados semelhantes, o Overleaf recomenda uma assinatura da sua plataforma SaaS.
O Ayakaleaf Pro é de código aberto. Revisamos o código com ferramentas como o Codex Security para reforçar a sua segurança e confiabilidade. Se você não ativar a sincronização de dados com terceiros, os seus dados permanecem no seu servidor. O Ayakaleaf Pro não contém telemetria que envie os seus dados para outro lugar.
Faremos todos os esforços para manter este projeto a longo prazo.
O Ayakaleaf Pro é um fork comunitário. O seu código e os recursos integrados vêm de contribuições da comunidade. Ele é licenciado sob a AGPL v3. As implantações podem estar em conformidade com esta licença quando cumprem os seus requisitos.
O projeto chamava-se originalmente Overleaf Pro em 2024. O desenvolvimento ficou pausado por um tempo e foi retomado no final de 2025. No primeiro trimestre de 2026, o Overleaf renomeou o seu plano de assinatura com IA para Pro. O feedback da comunidade também apontou que o nome Overleaf Pro poderia criar riscos relacionados a marcas registradas e de falsificação de identidade, podendo levar os usuários a pensar que o projeto era oficial.Renomeamos o projeto para Ayakaleaf Pro para evitar essa confusão. O nome pode ser lido como “Ayaka-notes Overleaf Pro”. O mantenedor (pode me chamar de ayaka!) contribui para o desenvolvimento da comunidade Overleaf desde os seus tempos de estudante, há mais de cinco anos. Essa experiência sustenta o nosso compromisso de manutenção a longo prazo.
Desde 2026, a comunidade de código aberto lançou muitos editores de LaTeX criados com IA, incluindo o OpenAI Prism. O Ayakaleaf Pro mantém os seus dados e serviços no seu próprio servidor. Isso lhe dá controle direto sobre a sua implantação e os seus dados.Muitos editores experimentais da comunidade não têm um plano de manutenção de longo prazo estabelecido. Plataformas de compilação LaTeX de terceiros também podem deixar de operar quando a sua base de usuários ou receita é insuficiente. O Ayakaleaf Pro disponibiliza todo o código-fonte e permite hospedar por conta própria todos os serviços. Mesmo que a manutenção parasse, o seu serviço auto-hospedado existente poderia continuar funcionando.
Ele foi renomeado para ayaka-notes/ayakaleaf-pro junto com a renomeação do projeto (veja a P08). Ele não foi arquivado nem substituído: é o mesmo repositório, e o GitHub redireciona os links antigos de ayaka-notes/overleaf-pro e os remotes do Git para o novo nome. A imagem Docker mantém o nome ghcr.io/ayaka-notes/overleaf-pro, portanto você não precisa alterar config/overleaf.rc nem config/version.

Recursos

Consulte a nossa documentação para ver a lista atual de recursos. Se houver um recurso que você gostaria que adicionássemos, sinta-se à vontade para abrir uma issue (de solicitação de recurso) no GitHub. Faremos o possível para implementar os recursos solicitados, mas o desenvolvimento leva tempo e não podemos garantir que todos os recursos sejam entregues imediatamente.
Contribuições são bem-vindas, mas a aceitação não é garantida. Avaliamos cada PR com base no seu impacto sobre o código-base do Overleaf subjacente, no esforço de manutenção que exige e no valor que traz aos usuários. Faremos o possível para mesclar e manter as contribuições valiosas.No entanto, podemos rejeitar PRs que introduzam alterações excessivas, que consistam em código gerado por IA não revisado ou mal compreendido (“vibe coding”) ou que adicionem recursos difíceis de manter ao longo do tempo.
Geralmente atualizamos a documentação sempre que lançamos um novo recurso. Consulte a documentação correspondente para obter instruções detalhadas de configuração e explicações sobre as variáveis de ambiente disponíveis.
O Python Runner executa Python no navegador do usuário com o Pyodide 0.29.3, e não no servidor. Ele carrega os pacotes que o seu código importa a partir dos pacotes integrados ao Pyodide, como NumPy, pandas e Matplotlib. Pacotes instalados com pip e outros pacotes não estão disponíveis. Não há nada a configurar no servidor.
Não. O verificador ortográfico não tem dicionário para japonês ou chinês, por isso esses idiomas não estão na lista de idiomas da verificação ortográfica. Os usuários podem desativar a verificação ortográfica de um projeto nas configurações do editor.Para impedir que uma palavra seja marcada como incorreta, clique nela com o botão direito e escolha Add to dictionary. As palavras adicionadas são salvas na sua conta e se aplicam a todos os seus projetos. Para revisá-las ou removê-las, abra as configurações do editor e, em seguida, Spelling and language → Dictionary → Edit. Adicionar palavras não adiciona um novo idioma de verificação ortográfica.
Não há instalador de plugins. Os recursos são módulos em services/web/modules do código-fonte, incorporados à imagem Docker e ativados com as configurações desta documentação. Para adicionar os seus próprios, adicione um módulo ao código-fonte e construa a sua própria imagem.

Implantação

Para a maioria dos usuários, recomendamos implantar com o Toolkit. O suporte ao Kubernetes é experimental: Usando o Kubernetes mostra os manifestos que testamos com uma ou várias réplicas, mas um cluster acrescenta complexidade operacional e esforço de manutenção. As Sandboxed Compiles criam seus contêineres de compilação por meio do socket do Docker, portanto todo nó que executa o Ayakaleaf Pro precisa do Docker Engine. Não fornecemos configurações para CRI-O, Podman ou Quadlet.
Consulte o nosso guia de escalabilidade horizontal. Você pode implantar várias instâncias do Overleaf e configurar um balanceador de carga para distribuir o tráfego entre elas.
Se você tiver uma instância existente do Overleaf Server Pro, teremos prazer em ajudá-lo a migrar para o Ayakaleaf Pro. Entre em contato por e-mail ou por issues.
Não. O Ayakaleaf Pro precisa ser servido a partir da raiz de um domínio. Use um domínio ou subdomínio dedicado, como https://overleaf.example.com.
Sim. O Toolkit funciona no Linux, no macOS com Docker Desktop e no Windows com WSL 2 e Docker Desktop. Recomendamos o Linux para servidores compartilhados e de produção. Os guias para macOS e Windows incluem a configuração das compilações em sandbox.Não fornecemos um docker-compose.yml independente. Para ver a configuração do Compose que o Toolkit usa, execute bin/docker-compose config no diretório do Toolkit.
Não há script de desinstalação. No diretório do Toolkit:
  1. Pare e remova os contêineres com bin/docker-compose down.
  2. Exclua os dados. Por padrão, eles ficam no diretório data/ do Toolkit. Se você alterou OVERLEAF_DATA_PATH, MONGO_DATA_PATH, REDIS_DATA_PATH ou GIT_BRIDGE_DATA_PATH em config/overleaf.rc, exclua também esses diretórios. Isso não pode ser desfeito, então faça um backup antes, caso possa precisar dos dados.
  3. Exclua o diretório do Toolkit.
  4. Remova as imagens Docker, que você pode listar com docker images: ghcr.io/ayaka-notes/overleaf-pro, a imagem do git-bridge, mongo, redis e as imagens do TeX Live.
Execute estes comandos no diretório do Toolkit:
  • bin/stop para todos os contêineres, e bin/start os inicia novamente. Os contêineres são mantidos, então os usuários continuam conectados.
  • bin/up -d cria os contêineres e os inicia em segundo plano. Execute-o depois de alterar config/variables.env, config/overleaf.rc ou config/version: ele recria os contêineres cuja configuração mudou, e só então as alterações entram em vigor. bin/stop e bin/start não as aplicam.
  • bin/docker-compose restart sharelatex reinicia apenas o contêiner do Overleaf, sem aplicar alterações de configuração.
Se os usuários forem desconectados sempre que o bin/up recriar o contêiner, defina OVERLEAF_SESSION_SECRET; consulte as Q&A em Variáveis de ambiente.
Na aplicação que você cria no provedor, e não no Ayakaleaf Pro. Não há configuração de callback em config/variables.env para nenhuma destas integrações: o Ayakaleaf Pro monta cada URL de callback a partir de OVERLEAF_SITE_URL e a envia ao provedor, que a rejeita a menos que corresponda à registrada para a aplicação. Portanto, você só a registra no provedor e define OVERLEAF_SITE_URL como o endereço que os usuários abrem.Se você alterar OVERLEAF_SITE_URL, por exemplo para um novo domínio, atualize também a URL em todos os provedores; caso contrário, a vinculação falha.
Por padrão, tudo fica no disco local do servidor, no diretório data/ do Toolkit: data/overleaf (arquivos dos projetos, histórico e saída de compilação), data/mongo e data/redis. Para instâncias com menos de 1000 usuários, recomendamos o disco local com backups regulares.A imagem do Ayakaleaf Pro ocupa cerca de 5 GB. O mínimo de 40 GB indicado na Introdução é para as Sandboxed Compiles, cujas imagens texlive-full ocupam cerca de 28 GB cada. Sem as Sandboxed Compiles, as compilações são executadas dentro do contêiner sharelatex com o esquema básico do TeX Live mais latexmk, texcount, synctex, etoolbox e xetex, de modo que muitos projetos falham por falta de pacotes. O diretório data/ então cresce com os seus projetos e o histórico deles; verifique-o com du -sh data/*.
Sim, desde que o Windows permaneça ativo e o Docker Desktop continue em execução. Ative Start Docker Desktop when you sign in to your computer, mantenha as políticas restart: always do Toolkit e desative o repouso e a hibernação automáticos enquanto estiver ligado na energia elétrica. A tela pode se desligar; o comportamento da tampa do notebook é uma configuração separada. Fechar o terminal do Ubuntu após bin/up -d não para os contêineres em modo destacado. Encerrar o Docker Desktop, pausar seu engine ou executar wsl --shutdown interrompe o serviço.O Resource Saver do Docker Desktop é diferente do repouso do Windows: ele se aplica quando não há contêineres em execução, portanto uma stack do Ayakaleaf em execução não fica ociosa só porque ninguém está editando. Após uma reinicialização do Windows, a configuração de inicialização no login ainda exige que alguém inicie sessão. Siga Manter a instância disponível para as verificações e etapas de recuperação. O Linux continua sendo a nossa recomendação quando a disponibilidade não pode depender de um login interativo na área de trabalho.
Este guia usa o backend WSL 2. Ele precisa da virtualização da CPU ativada na BIOS/UEFI, do recurso Virtual Machine Platform do Windows e de uma instalação funcional do WSL 2. O recurso Hyper-V completo é um backend separado do Docker Desktop e não é pré-requisito para esta configuração com WSL.Verifique Gerenciador de Tarefas → Desempenho → CPU → Virtualização e wsl --list --verbose no PowerShell. Erros como 0x80370102 podem significar que a virtualização, o recurso do Windows ou o hipervisor de inicialização está desativado. Consulte as etapas de solução de problemas da instalação no Windows, com os links de reparo da Microsoft e do Docker. Reinicie o Windows após ativar os recursos necessários; reinstalar o Ayakaleaf não corrige um engine do Docker que não inicia.

LaTeX

Ao ativar as Sandbox Compiles, a compilação de cada usuário é executada num contêiner Docker separado e fica isolada das compilações dos outros usuários. O Shell Escape está ativado por padrão nas Sandbox Compiles.
Aprimoramos a nossa imagem TeX Live Full para Sandbox Compiles ao longo dos últimos três anos. Na maioria dos casos, os projetos que compilam no overleaf.com também compilam corretamente com o Ayakaleaf Pro. Se uma fonte necessária não estiver disponível, carregue essa fonte manualmente no seu projeto.
Carregue o seu projeto no site oficial do Overleaf, ative o compartilhamento por link somente leitura e inclua o link em uma issue no GitHub.Investigaremos e corrigiremos quaisquer bugs que impeçam um projeto de compilar no Ayakaleaf Pro quando ele compila com sucesso no site oficial do Overleaf. Problemas de compilação fora desse escopo não são cobertos pelo nosso suporte.
Última modificação em 8 de novembro de 2026