> 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/it/manutenzione/upgrading-your-deployment.md).
# Aggiornamento della tua distribuzione
{% hint style="danger" %}
È importante assicurarsi di eseguire un [backup coerente](/on-premises/it/manutenzione/data-and-backups.md#performing-a-consistent-backup) **prima di** a ogni aggiornamento di versione principale, per consentirti di tornare indietro 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 che stai eseguendo. Questo significa che, nella maggior parte dei casi, puoi aggiornare la versione del Toolkit senza aggiornare la tua 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 allinearlo al nuovo valore predefinito.
Se scegli di cambiare versione, lo script ti guiderà attraverso un processo di arresto dei servizi Docker, esecuzione 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 principale distribuita **prima di** aggiornare all'ultima release della **successiva** versione principale. Se la tua distribuzione è indietro di più di una versione principale rispetto all'ultima, ti sarà richiesto di eseguire un aggiornamento in più passaggi.
Ad esempio, se stai eseguendo la 3.5.10, dovrai aggiornare alla 3.5.13 -> eseguire la migrazione completa della cronologia del progetto -> 4.2.9 -> 5.5.4.
Dovresti **mai** saltare le versioni principali (3.5.10 -> 5.5.4). Se utilizzi il Toolkit e sei indietro di più di una versione principale rispetto all'ultima, devi **non** usare lo `bin/upgrade` script, poiché dovrai eseguire un aggiornamento manuale in più passaggi.
{% endhint %}
{% hint style="info" %}
Per configurazioni air-gapped che importano manualmente le immagini Docker, imposta `PULL_BEFORE_UPGRADE=false` nel tuo `config/overleaf.rc` nel file.
Consulta [qui](/on-premises/it/installazione/air-gapped-offline-deployments.md) per maggiori informazioni sul deployment 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 è infrequente, ciò potrebbe comportare il salto di versioni principali e potenzialmente l'aggiornamento a una versione che non ti aspettavi.
Quando esegui un aggiornamento, consigliamo di aggiornare prima all'ultima release della versione principale attuale e poi all'ultima release della successiva versione principale. Ad esempio, se al momento stai eseguendo 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 eseguire qualsiasi aggiornamento, poiché alcune versioni potrebbero richiedere passaggi aggiuntivi, come modifiche manuali al Toolkit, aggiornamenti dei database o l'esecuzione di script di migrazione.
Se non l'hai ancora fatto, iscriverti alla nostra [mailing list](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) in modo da essere avvisato quando vengono rilasciate nuove versioni/aggiornamenti. Questo ti consentirebbe 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://overleaf-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.