Package installation

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. Give it a try with a free trial instance!

Supported operating systems

For package installation, the following Linux distributions are supported:

Distribution	Version
CentOS/RHEL	9, 10
Debian	11, 12 & 13
OpenSUSE Leap / SLES	15 & 16
Ubuntu	22.04, 24.04 & 26.04

Se la tua distribuzione non è supportata, puoi utilizzare un metodo di installazione diverso o valutare l'utilizzo del servizio cloud di Zammad.

Per seguire i passaggi di installazione descritti di seguito, sono necessari strumenti come curl, gnupg e altri. Se non sono presenti sul sistema, installateli:

sudo apt install curl apt-transport-https gnupg

Nozioni di base

Ensure correct locale

sudo apt install curl apt-transport-https gnupg

Installa Elasticsearch

Il metodo consigliato è quello di utilizzare la guida ufficiale di Elasticsearch per installare Elasticsearch.

In alternativa, puoi seguire la nostra procedura di installazione di esempio di Elasticsearch 9, che è stata separata per mantenere le istruzioni di installazione il più snelle possibile.

Add Zammad repository

INFO

Packager.io potrebbe non essere accessibile da ambienti solo IPv6, quindi assicurati di considerare questo aspetto.

Aggiungi la chiave del repository:

sudo curl -fsSL "https://go.packager.io/srv/deb/zammad/zammad/gpg-key.gpg" \

-o /usr/share/keyrings/zammad.gpg && sudo chmod 644 /usr/share/keyrings/zammad.gpg

Aggiungi il repository (Ubuntu 22.04):

sudo curl -fsSL "https://go.packager.io/srv/zammad/zammad/stable/installer/ubuntu/22.04.list" \

-o /etc/apt/sources.list.d/zammad.list

Aggiungi il repository (Ubuntu 24.04):

sudo curl -fsSL "https://go.packager.io/srv/zammad/zammad/stable/installer/ubuntu/24.04.list" \

-o /etc/apt/sources.list.d/zammad.list

Aggiungi repository (Ubuntu 26.04):

sudo curl -fsSL "https://go.packager.io/srv/zammad/zammad/stable/installer/ubuntu/26.04.list" \

-o /etc/apt/sources.list.d/zammad.list

Installa Zammad

sudo apt update

sudo apt install zammad

Manage services of Zammad

Zammad utilizza tre servizi. Questi servizi possono essere gestiti singolarmente o tutti insieme tramite il servizio principale zammad.

• zammad: include i servizi seguenti
  • zammad-web: server puma interno (rilevante per visualizzare la web app)
  • zammad-worker: worker in background - rilevante per tutti i job ritardati e in background
  • zammad-websocket: WebSocket server for session related information

Gestisci i servizi con i comandi systemctl start, restart, stop, status.

Esempio per avviare Zammad con tutti i sotto-servizi:

sudo systemctl start zammad

Per fermare o riavviare un servizio o controllare il suo stato, regola il comando come indicato sopra.

Next steps

• Collega Zammad con Elasticsearch
• Regola le tue regole SELinux e il firewall
• Configura il server web

Dipendenze

Supponendo un sistema standard, le seguenti dipendenze verranno installate automaticamente durante l'installazione del pacchetto Zammad. Inoltre, di seguito sono riportate alcune informazioni su Elasticsearch, che non viene installato automaticamente.

• imlib2
• Node.js
• PostgreSQL
• Nginx
• Redis

Database server

Zammad memorizza i suoi contenuti in un database. Il sistema di database supportato è PostgreSQL versione 15 o successiva. Se non viene rilevato alcun server PostgreSQL, verrà installato automaticamente durante l'installazione del pacchetto.

WARNING

Se utilizzi un software di pooling delle connessioni al database come PgBouncer, assicurati di utilizzare una modalità di pooling completamente compatibile con PostgreSQL. In genere, questa modalità viene chiamata "session connection pooling". Il connection pooling basato sulle transazioni non è supportato e potrebbe causare errori durante le migrazioni del database.

Reverse proxy

I seguenti proxy inversi sono supportati nelle versioni attualmente mantenute:

• Nginx
• Apache

Lo script di installazione tenta di rilevare Apache o Nginx durante l'installazione. Se non ne trova nessuno, Nginx viene installato automaticamente. Puoi trovare un esempio di base nella nostra guida alla configurazione del server web.

Redis

Redis is required for realtime communication via web socket. Zammad requires Redis 7 or newer. It gets installed automatically (package) or is included in the stack (Docker Compose) with a working configuration. However, the installation and configuration is out of scope of this documentation. Please follow the official guides and ensure to set it up in a secure way.

Le variabili d'ambiente disponibili per le configurazioni standard e Sentinel sono brevemente menzionate nella pagina Variabili Redis.

INFO

CentOS and RHEL 10 use Valkey as a drop-in-replacement for Redis. During the Zammad installation on those distros, it gets installed automatically as a dependency.

Elasticsearch opzionale altamente consigliato

Elasticsearch non viene installato automaticamente. Poiché è fondamentale per una corretta configurazione di Zammad, è incluso nelle istruzioni di installazione sopra riportate. Se si desidera connettere Zammad a un'istanza di Elasticsearch già esistente, assicurarsi di utilizzare una versione supportata e consultare il nostro esempio di configurazione.

Le versioni di Elasticsearch supportate sono 8.11 - 9.x.

Cronologia versioni di Elasticsearch per Zammad:

Details

Zammad	Elasticsearch
7.2+	>= 8.11, <10
7.0-7.1	>= 7.8, <10
5.2-6.5	>= 7.8, <9
5.0-5.1	>= 7.8, <8
4.0-4.1	>= 6.5, <=7.12
3.4-3.6	>= 5.5, <=7.9
3.3	>= 2.4, <=7.6
3.2	>= 2.4, <=7.5
3.1	>= 2.4, <=7.4
2.0-3.0	>= 2.4, <=5.6

Memcached

Zammad fa ampio ricorso alla cache per migliorare le prestazioni. Questa cache può essere memorizzata nel file system senza dipendere da servizi esterni. Tuttavia, ciò è possibile solo se tutti i servizi di Zammad sono in esecuzione sullo stesso file system!

In tutti gli altri casi, come la distribuzione di Zammad tramite container (Docker o Kubernetes) o su nodi cluster separati, è necessario un servizio Memcached per memorizzare la cache e fornirla a tutte le istanze di Zammad. Gli stack Docker e Kubernetes includono già questo servizio.

Tuttavia, anche le installazioni su file system locali possono beneficiare dei miglioramenti prestazionali di Memcached. Potresti voler dare un'occhiata anche alla nostra sezione ottimizzazione delle prestazioni.

L'installazione e la configurazione non rientrano nell'ambito di questa documentazione. Qualora fosse necessario installare Memcached manualmente, si prega di consultare la documentazione ufficiale di Memcached.

GnuPG opzionale

Se desideri utilizzare l'integrazione PGP per inviare e ricevere email firmate e crittografate, devi installare GnuPG-Tool. Consulta il sito ufficiale di GnuPG all'indirizzo [https://www.gnupg.org/index.html]{target=_blank}.