---
url: https://next.zammad.org/it/get-started/update.md
---

# Aggiornare Zammad

::: tip
Are you tired of complex setup, configuration, backup and update tasks? Let us
handle this stuff for you! 🚀

The easiest and often most cost-effective way to operate Zammad is our
[cloud service](https://zammad.com/en/pricing){target=\_blank}. Give it a try
with a free trial instance!
:::

Before updating Zammad, we strongly recommend to take a look at our [release
notes](https://zammad.com/en/releases){target=\_blank}. You can find
information about features, fixes and technical remarks and breaking
changes.

Tieni presente che non dovresti saltare le versioni principali di Zammad
durante l'aggiornamento. Ciò significa, ad esempio, che il tuo percorso di
aggiornamento dalla versione `2.4` alla `5.1` (supponendo che questa sia la
versione stabile attuale) sarebbe: `2.4` → `3.0` → `4.0` → `5.0` → `ultima
versione stabile (5.1)`

::: info
Questa pagina descrive come aggiornare solo Zammad. Se desideri aggiornare anche il sistema operativo host, consulta le istruzioni per [Aggiornamento host e migrazione repository](host-upgrade-repo-migration).
:::

## Update package installation

### Check dependencies

Prima di procedere, verifica che il tuo ambiente di sistema corrisponda ai
requisiti di Zammad (vedi [Prerequisiti](installation/prerequisites) e
[Installazione del pacchetto](installation/package)).

### Ferma Zammad

```sh
sudo systemctl stop zammad
```

### Backup di Zammad

Crea un backup. Puoi usare lo [script di
backup](/it/tutorials/backup-restore) incluso.

### Aggiorna Zammad

::: info
Se aggiorni l'intero sistema e sono disponibili aggiornamenti sia per Zammad \*\* e\*\* per il tuo server di database, potrebbero verificarsi degli errori perché il database potrebbe non essere nuovamente online dopo l'aggiornamento di Zammad.

In tal caso, potresti voler escludere temporaneamente Zammad dagli aggiornamenti, come puoi vedere nei comandi seguenti.
:::

::: tabs key:distros

\=== Ubuntu
Aggiorna gli elenchi dei pacchetti:

```sh
sudo apt update
```

Disabilita gli aggiornamenti per Zammad:

```sh
sudo apt-mark hold zammad
```

Aggiorna tutti i pacchetti tranne Zammad:

```sh
sudo apt upgrade
```

Riattiva gli aggiornamenti per Zammad:

```sh
sudo apt-mark unhold zammad
```

Aggiorna Zammad:

```sh
sudo apt upgrade
```

\=== Debian
Aggiorna gli elenchi dei pacchetti:

```sh
sudo apt update
```

Disabilita gli aggiornamenti per Zammad:

```sh
sudo apt-mark hold zammad
```

Aggiorna tutti i pacchetti tranne Zammad:

```sh
sudo apt upgrade
```

Riattiva gli aggiornamenti per Zammad Zammad:

```sh
sudo apt-mark unhold zammad
```

Aggiorna Zammad:

```sh
sudo apt upgrade
```

\=== OpenSUSE/SLES

Aggiorna gli elenchi dei pacchetti:

```sh
sudo zypper refresh
```

Disabilita gli aggiornamenti per Zammad:

```sh
sudo zypper addlock zammad
```

Aggiorna tutti i pacchetti tranne Zammad:

```sh
sudo zypper update
```

Riabilita gli aggiornamenti per Zammad:

```sh
sudo zypper removelock zammad
```

Aggiorna Zammad:

```sh
sudo zypper update
```

\=== CentOS/RHEL

Aggiorna tutti i pacchetti tranne Zammad:

```sh
sudo dnf upgrade --exclude zammad
```

Aggiornamento di Zammad:

```sh
sudo dnf upgrade
```

:::

### Additional steps

Potrebbe essere rilevante anche l'aggiornamento di Elasticsearch. Assicurati
di avere installata una versione supportata di Elasticsearch (vedi
[installazione del
pacchetto](/it/get-started/installation/package#elasticsearch) per le
versioni supportate).

Se devi aggiornare Elasticsearch, consulta la [loro
documentazione](https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-upgrade.html){target=\_blank}
e segui le istruzioni.

### Rebuild Elasticsearch index 

Necessario solo se le note di rilascio ti dicono di ricostruire l'indice
Elasticsearch.

Senza specificare i core CPU da usare:

```sh
zammad run rake zammad:searchindex:rebuild
```

Specificando i core CPU da usare (esempio 8):

```sh
zammad run rake zammad:searchindex:rebuild[8]
```

### Avvia Zammad

```sh
sudo systemctl start zammad
```

## Update Docker installation

::: warning
Docker Compose stack updates may require extra steps or introduce breaking
changes. Always check the [Docker Compose release notes](https://github.com/zammad/zammad-docker-compose/releases){target=\_blank}
for update instructions first.
:::

::: tip
If you want to update Zammad to a specific version, use the `VERSION` environment variable
([example](https://github.com/zammad/zammad-docker-compose/blob/master/.env.dist){target=\_blank}
with further explanation) and specify the version number.
:::

### Updating Portainer based installations

Nel tuo stack Zammad, fai clic su `Pull and redeploy`, attiva **Re-pull
image and redeploy**.

![Aggiornamento dello stack evidenziato in
Portainer](/screenshots/get-started/installation/portainer-stack-update.png)

### Updating Docker Compose based installations

```sh
cd zammad-docker-compose
```

```sh
git pull
```

```sh
docker compose pull
```

```sh
docker compose up -d
```

### Rebuild Elasticsearch index 

Necessario solo se le note di rilascio ti dicono di ricostruire l'indice
Elasticsearch.

::: tabs key:docker-portainer

\=== Docker Compose

Without specifying CPU cores:

```sh
docker compose run --rm zammad-railsserver bundle exec rake zammad:searchindex:rebuild
```

With specifying CPU cores to use (example 8):

```sh
docker compose run --rm zammad-railsserver bundle exec rake zammad:searchindex:rebuild[8]
```

\=== Portainer

Open the [console via Portainer's GUI](/en/get-started/installation/docker#how-to-run-commands-in-the-stack) with the
standard entrypoint `/bin/bash` and run:

Without specifying CPU cores to use:

```sh
bundle exec rake zammad:searchindex:rebuild
```

With specifying CPU cores to use (example 8):

```sh
bundle exec rake zammad:searchindex:rebuild[8]
```

:::