> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-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 permitir que possa 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 há uma atualização disponível para o código do Toolkit e oferecerá a atualização do seu Toolkit. Pode sempre responder não a esta atualização, e nada mudará.
Se optar por atualizar o código do Toolkit, o script irá então verificar se a *predefinida* versão da imagem Docker mudou e oferecerá a atualização do seu ficheiro de versão local (em `config/version`) para corresponder à nova predefinição.
Se optar por mudar de versão, o script irá então guiá-lo através de um processo de encerramento dos serviços Docker, criação de uma cópia de segurança e reinício dos serviços Docker. O seu ficheiro de versão antigo será copiado automaticamente para `config/__old-version`, caso precise de reverter para essa versão das imagens Docker.
{% hint style="danger" %}
Ao efetuar uma atualização do Server CE/Pro, recomendamos atualizar para a versão de lançamento mais recente da versão principal implementada **antes de** atualizar para a versão de lançamento mais recente da **seguinte** versão principal. Se a sua implementação estiver a mais de uma versão principal atrás da mais recente, será necessário efetuar 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 do Histórico Completo do Projeto -> 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 a mais de uma versão principal atrás da mais recente, deve **não** usar o `bin/upgrade` script, pois terá de efetuar uma atualização manual em várias etapas.
{% endhint %}
{% hint style="info" %}
Para configurações isoladas da rede que importam imagens Docker manualmente, 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 isolados da rede/offline.
{% endhint %}
### Caminho de atualização
O `bin/upgrade` o comando escolherá sempre a versão mais recente do Server Pro/CE disponível nesse momento. Se o seu ciclo de atualização for pouco frequente, isto poderá resultar na omissão de versões principais e potencialmente na atualização para uma versão que não esperava.
Ao efetuar uma atualização, recomendamos atualizar 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 a versão 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. Como, por exemplo, fazer alterações manuais ao Toolkit, atualizar bases de dados ou executar scripts de migração.
Se ainda não o fez, subscreva a nossa [lista de correio eletrónico](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) para que possa ser notificado quando novas versões/atualizações forem lançadas. Isto permitir-lhe-á agendar janelas de manutenção regulares que sigam 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://overleaf-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.