> 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/manutencao/upgrading-your-deployment.md).
# Atualizar a sua implementação
{% hint style="danger" %}
É importante garantir que faz uma [cópia de segurança consistente](/on-premises/pt/manutencao/data-and-backups.md#performing-a-consistent-backup) **antes de** em cada atualização de versão principal para lhe permitir reverter, caso seja necessário.
{% endhint %}
O [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) é um repositório git, por isso é fácil obter novas funcionalidades do Toolkit. Basta executar o `bin/upgrade` comando e seguir as instruções no ecrã.
Vale a pena notar que a versão da imagem Docker (em `config/version`) é gerida separadamente das atualizações do código do Toolkit. Atualizar o código do Toolkit irá **não** alterar automaticamente a versão da imagem Docker que está a executar. Isto significa que, na maioria dos casos, pode atualizar a sua versão do Toolkit sem atualizar a sua implementação.
#### O `bin/upgrade` Script
Quando executar o `bin/upgrade` comando, o script verificará se existe uma atualização disponível para o código do Toolkit e oferecerá a atualização do seu Toolkit. Pode sempre recusar esta atualização, e nada mudará.
Se optar por atualizar o código do Toolkit, o script verificará então se a *predefinida* versão da imagem Docker foi alterada e oferecerá atualizar o seu ficheiro de versão local (em `config/version`) para corresponder à nova predefinição.
Se optar por mudar de versão, o script guiá-lo-á através de um processo de encerrar os serviços Docker, fazer uma cópia de segurança e reiniciar os serviços Docker. O seu ficheiro de versão antigo será automaticamente copiado para `config/__old-version`, caso precise de reverter para essa versão das imagens Docker.
{% hint style="danger" %}
Ao realizar uma atualização do Server CE/Pro, recomendamos atualizar para a versão mais recente da versão principal implementada **antes de** atualizar para a versão mais recente da **seguinte** versão principal. Se a sua implementação estiver mais de uma versão principal atrás da mais recente, será necessário realizar uma atualização em várias etapas.
Por exemplo, se estiver a executar 3.5.10, terá de atualizar para 3.5.13 -> Executar a migração Full Project History -> 4.2.9 -> 5.5.4.
Deve **nunca** saltar versões principais (3.5.10 -> 5.5.4). Se estiver a usar o Toolkit, e estiver mais de uma versão principal atrás da mais recente, deve **não** utilizar o `bin/upgrade` script, pois terá de realizar uma atualização manual em várias etapas.
{% endhint %}
{% hint style="info" %}
Para configurações air-gapped que importam manualmente imagens Docker, defina `PULL_BEFORE_UPGRADE=false` no seu `config/overleaf.rc` no ficheiro.
Consulte [aqui](/on-premises/pt/instalacao/air-gapped-offline-deployments.md) para mais informações sobre a implementação em ambientes air-gapped/offline.
{% endhint %}
### Caminho de atualização
O `bin/upgrade` comando escolherá sempre a versão mais recente do Server Pro/CE disponível nesse momento. Se o seu ciclo de atualização for infrequente, isto poderá resultar na omissão de versões principais e potencialmente na atualização para uma versão que talvez não esperasse.
Ao efetuar uma atualização, recomendamos que atualize para a versão mais recente da versão principal atual antes de atualizar para a versão mais recente da próxima versão principal. Por exemplo, se estiver atualmente a executar 3.3.2 e a versão mais recente disponível for 5.3.1, o caminho de atualização correto seria:
* 3.3.2 -> 3.5.13
* 3.5.13 -> 4.2.9
* 4.2.9 -> 5.5.1
Para evitar quaisquer problemas de atualização, recomendamos consultar as nossas [Notas de lançamento](https://docs.overleaf.com/on-premises/release-notes) antes de efetuar quaisquer atualizações, uma vez que certas versões podem exigir passos adicionais. Tal como fazer alterações manuais ao Toolkit, atualizar bases de dados ou executar scripts de migração.
Se ainda não o fez, inscreva-se na nossa [lista de correio eletrónico](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) para que possa ser notificado quando forem lançadas novas versões/atualizações. Isto permitir-lhe-á agendar janelas de manutenção regulares que acompanhem de perto o nosso calendário de lançamentos.
---
# 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/manutencao/upgrading-your-deployment.md?ask=&goal=
```
`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.