> 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/it/manutenzione/upgrading-your-deployment.md).
# Aggiornamento della tua distribuzione
{% hint style="danger" %}
È importante assicurarti di eseguire un [backup consistente](/on-premises/it/manutenzione/data-and-backups.md#performing-a-consistent-backup) **prima** a ogni aggiornamento di versione major, per poterti consentire un rollback se necessario.
{% endhint %}
Il [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) è un repository git, quindi è facile ottenere nuove funzionalità del Toolkit. Basta eseguire il `bin/upgrade` comando e seguire le istruzioni sullo schermo.
Vale la pena notare che la versione dell'immagine Docker (in `config/version`) è gestita separatamente dagli aggiornamenti del codice del Toolkit. L'aggiornamento del codice del Toolkit **non** cambierà automaticamente la versione dell'immagine Docker in esecuzione. Ciò significa che, nella maggior parte dei casi, è possibile aggiornare la versione del Toolkit senza aggiornare la distribuzione.
#### Il `bin/upgrade` Script
Quando esegui il `bin/upgrade` comando, lo script verificherà se è disponibile un aggiornamento del codice del Toolkit e ti offrirà di aggiornare il tuo Toolkit. Puoi sempre rifiutare questo aggiornamento, e non cambierà nulla.
Se scegli di aggiornare il codice del Toolkit, lo script verificherà quindi se la *predefinita* versione dell'immagine Docker è cambiata e ti offrirà di aggiornare il tuo file di versione locale (in `config/version`) per farlo corrispondere al nuovo valore predefinito.
Se scegli di cambiare versione, lo script ti guiderà quindi attraverso un processo di arresto dei servizi Docker, creazione di un backup e riavvio dei servizi Docker. Il tuo vecchio file di versione verrà copiato automaticamente in `config/__old-version`, nel caso in cui tu debba tornare a quella versione delle immagini Docker.
{% hint style="danger" %}
Quando esegui un aggiornamento di Server CE/Pro, consigliamo di aggiornare all'ultima release della versione major distribuita **prima** di aggiornare all'ultima release della **successiva** versione major. Se la tua distribuzione è indietro di più di una versione major rispetto all'ultima, sarà necessario eseguire un aggiornamento in più fasi.
Ad esempio, se stai eseguendo 3.5.10, dovrai aggiornare a 3.5.13 -> eseguire la migrazione completa della cronologia del progetto -> 4.2.9 -> 5.5.4.
Dovresti **mai** saltare versioni major (3.5.10 -> 5.5.4). Se stai usando il Toolkit e sei indietro di più di una versione major rispetto all'ultima, non devi **non** usare lo `bin/upgrade` script, perché dovrai eseguire un aggiornamento manuale in più fasi.
{% endhint %}
{% hint style="info" %}
Per configurazioni air-gapped che importano manualmente le immagini Docker, imposta `PULL_BEFORE_UPGRADE=false` nel tuo `config/overleaf.rc` file.
Consulta [qui](/on-premises/it/installazione/air-gapped-offline-deployments.md) per ulteriori informazioni sulla distribuzione in ambienti air-gapped/offline.
{% endhint %}
### Percorso di aggiornamento
Il `bin/upgrade` comando sceglierà sempre la versione più recente di Server Pro/CE disponibile in quel momento. Se il tuo ciclo di aggiornamento è poco frequente, ciò potrebbe comportare il salto di versioni principali e potenzialmente l'aggiornamento a una versione che non ti aspettavi.
Quando esegui un aggiornamento, ti consigliamo di passare prima all'ultima release della versione principale corrente prima di aggiornare all'ultima release della successiva versione principale. Ad esempio, se attualmente stai usando la 3.3.2 e l'ultima versione disponibile è la 5.3.1, il percorso di aggiornamento corretto sarebbe:
* 3.3.2 -> 3.5.13
* 3.5.13 -> 4.2.9
* 4.2.9 -> 5.5.1
Per evitare problemi durante l'aggiornamento, ti consigliamo di consultare le nostre [Note di rilascio](https://docs.overleaf.com/on-premises/release-notes) prima di effettuare qualsiasi aggiornamento, poiché alcune versioni potrebbero richiedere passaggi aggiuntivi, come apportare modifiche manuali al Toolkit, aggiornare i database o eseguire script di migrazione.
Se non l'hai ancora fatto, iscriverti alla nostra [lista di distribuzione](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) in modo da ricevere una notifica quando vengono rilasciate nuove versioni/aggiornamenti. Questo ti permetterebbe di pianificare finestre di manutenzione regolari che seguano da vicino il nostro calendario di rilascio.
---
# 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/it/manutenzione/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.