> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/pt/instalacao/introduction.md).

# Introdução

Tal como o Overleaf Server Pro, o nosso Ayakaleaf Pro vem como um contentor Docker e é um substituto direto, incluindo adicionalmente funcionalidades como SSO fornecido via LDAP e SAML2, segurança melhorada, alterações acompanhadas, comentários, a nossa versão otimizada do TeX Live, modelos e painel de administração.

* Se nunca implementou qualquer versão do Overleaf antes, consulte [Configurar o Docker](/on-premises/pt/instalacao/setup-docker.md) para instalar primeiro o Docker Engine e depois instalar o Overleaf [usando o Toolkit](/on-premises/pt/instalacao/using-the-toolkit.md).
* Se já implementou a Community Edition do Overleaf, consulte [Migrar a partir de uma instalação existente](/on-premises/pt/instalacao/migrar-a-partir-de-uma-instalacao-existente.md) para migrar para o Ayakaleaf-Pro.
* Se já é utilizador do Server Pro, abra uma issue para nos informar antes de migrar para o AyakaLeaf Pro, uma vez que os dados dos modelos são armazenados num formato ligeiramente diferente.
* Por vezes, se um dia se cansar do nosso AyakaLeaf Pro e quiser voltar para a Community Edition oficial do Overleaf, isso é totalmente suportado. Nenhum dos seus dados será perdido. Para utilizadores do Overleaf Toolkit oficial, basta remover o seu ficheiro YAML de substituição. Para utilizadores do toolkit ayaka-notes, desative a `SERVER_PRO` opção. Tudo voltará então para a Community Edition padrão.

### Requisitos de hardware

* 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 TeX Live, são necessários pelo menos 40 GB de armazenamento para permitir a compilação em sandbox.
* Se quiser instalar o conjunto completo de imagens TeX Live de 2020 a 2026, certifique-se de que tem pelo menos 150 GB de espaço livre em disco disponível.

Aqui estão algumas configurações de hardware recomendadas para diferentes cenários de utilização:

| Caso de uso                                                   | Configuração recomendada                                                                       |
| ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Uso pessoal, com colaboração ocasional                        | 2 núcleos de CPU, 4 GB de RAM                                                                  |
| Pequenas equipas, até 10 utilizadores com colaboração ligeira | 2 núcleos de CPU, 8 GB de RAM                                                                  |
| Equipas de média dimensão, até 100 utilizadores               | 4 núcleos de CPU, 16 GB de RAM                                                                 |
| Implementações em grande escala ou em universidades           | Implementação em cluster distribuído; contacte-nos se precisar de assistência na implementação |

### Requisitos de software

Quanto aos requisitos de software, recomendamos usar uma versão recente do Ubuntu juntamente com a versão estável mais recente do Docker.

Não recomendamos implementar o AyakaLeaf Pro no Windows ou noutros sistemas operativos não suportados, pois poderá encontrar problemas de compatibilidade ou problemas inesperados durante a instalação e operação.

### Desempenho do LaTeX

O LaTeX é um programa de thread única, o que significa que só pode utilizar um núcleo de CPU de cada vez. A CPU é também a principal limitação ao compilar um único documento. Portanto, quanto melhor for o desempenho de um único núcleo da sua CPU, mais rapidamente conseguirá compilar um documento. Mais núcleos só ajudarão se estiver a tentar compilar mais documentos do que os núcleos de CPU livres que tem.

Usando o [modelo ThuThesis](https://www.overleaf.com/latex/templates/thuthesis-tsinghua-university-thesis-latex-template/cfwgcxtvkbsx) como exemplo, o tempo de compilação é de cerca de 6 segundos num Intel Core i9-14900K (5,6 GHz), enquanto demora cerca de 13 segundos numa instância Azure Standard D2as v5 (2 vCPUs, 8 GiB de RAM) 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 funciona a velocidades de relógio tão elevadas como a do 14900K, por isso terá de fazer um compromisso entre custo e سرعت? Let's ensure Portuguese only. Need correct last translation. The original&#x20;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/pt/instalacao/introduction.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
