Paket-Installation

TIP

Haben Sie genug von komplizierten Aufgaben rund um die Einrichtung, Konfiguration, Sicherung und Aktualisierung? Lassen Sie uns diese Dinge für Sie erledigen! 🚀

Der einfachste und oft auch kostengünstigste Weg, Zammad zu betreiben, ist unser Cloud-Dienst. Testen Sie es in einer kostenlosen Testinstanz!

Unterstützte Betriebssysteme

Für die Paket-Installation werden die folgenden Linux-Distributionen unterstützt:

Distribution	Version
CentOS/RHEL	8 & 9
Debian	11 & 12
OpenSUSE/SLES	Leap 15.x / 15
Ubuntu	20.04, 22.04, 24.04

Wenn Ihre Distribution nicht unterstützt wird, können Sie eine andere Installationsmethode verwenden oder Zammads Cloud Service in Betracht ziehen.

Um die folgenden Installationsschritte durchzuführen, müssen Sie möglicherweise zusätzliche Tools wie curl, gnupg und andere installieren.

Required Tools

sudo apt install curl apt-transport-https gnupg

Schnellstart

Korrekte Sprache/Gebietsschema sicherstellen

Listen Sie Ihre aktuellen Einstellungen für die Sprache auf:

locale | grep "LANG="

Wenn die Ausgabe nicht <lang_code>.utf8 ist, können Sie dieses Problem wie folgt beheben:

sudo apt install locales

sudo locale-gen en_US.UTF-8

echo "LANG=de_US.UTF-8" > sudo /etc/default/locale

Nachdem Sie den Fehler behoben haben, überprüfen Sie die Ausgabe noch einmal auf <lang_code>.utf8. Ein Neustart kann helfen, wenn dies nicht erfolgreich war.

Elasticsearch installieren

Die empfohlene Methode ist die Verwendung von Elastics offizieller Installationsanleitung.

Alternativ können Sie unserem Beispiel-Setup für Elasticsearch 7 folgen, das Sie auf einer anderen Seite finden, um die Installationsanweisungen so schlank wie möglich zu halten.

Zammad-Repository hinzufügen

INFO

Es kann sein, dass Packager.io aus reinen IPv6-Umgebungen nicht erreichbar ist, daher sollten Sie dies bei der Durchführung der folgenden Schritte berücksichtigen.

Repository Key eintragen::

curl -fsSL https://dl.packager.io/srv/zammad/zammad/key | \
gpg --dearmor | sudo tee /etc/apt/keyrings/pkgr-zammad.gpg> /dev/null

Ubuntu 20.04

echo "deb [signed-by=/etc/apt/keyrings/pkgr-zammad.gpg] https://dl.packager.io/srv/deb/zammad/zammad/stable/ubuntu 20.04 main"| \
sudo tee /etc/apt/sources.list.d/zammad.list > /dev/null

Ubuntu 22.04

echo "deb [signed-by=/etc/apt/keyrings/pkgr-zammad.gpg] https://dl.packager.io/srv/deb/zammad/zammad/stable/ubuntu 22.04 main"| \
sudo tee /etc/apt/sources.list.d/zammad.list > /dev/null

Ubuntu 24.04

INFO

Beginnend mit Ubuntu 24.04 enthält diese Doku den Befehl zum Hinzufügen des Repositorys im [deb822-Format] (https://repolib.readthedocs.io/en/latest/deb822-format.html).

printf "Types: deb
URIs: https://dl.packager.io/srv/deb/zammad/zammad/stable/ubuntu
Suites: 22.04
Components: main
Signed-By: /etc/apt/keyrings/pkgr-zammad.gpg" | \
sudo tee /etc/apt/sources.list.d/zammad.sources > /dev/null

Zammad installieren

sudo apt update

sudo apt install zammad

Zammad Services verwalten

Zammad verwendet drei Dienste. Sie können mit dem übergeordneten Dienst zammad (neu) gestartet und gestoppt werden:

systemctl (status|start|stop|restart) zammad

Nur interner Puma-Server (relevant zum Anzeigen der Web-App):

systemctl (status|start|stop|restart) zammad-web

Nur Background Worker - relevant für alle verzögerten und Hintergrund-Jobs:

systemctl (status|start|stop|restart) zammad-worker

Nur Websocket-Server für sitzungsbezogene Informationen:

systemctl (status|start|stop|restart) zammad-websocket

Nächste Schritte

• Zammad mit Elasticsearch verbinden (Basis Anleitung)
• Passen Sie Ihre SELinux-Regeln und Ihre Firewall an (Basis Anleitung)
• Konfigurieren Sie den Webserver (Basis Anleitung)

Abhängigkeiten

Sofern Sie eine Standardinstallation verwenden werden die folgenden Abhängigkeiten während der Installation des Zammad-Pakets automatisch installiert. Zusätzlich finden Sie unten einige Informationen über Elasticsearch, das nicht automatisch installiert wird.

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

Datenbank-Server

Zammad stores its content in a database. The supported database system is PostgreSQL 10 or newer.

If no PostgreSQL server could be detected, it will be installed automatically during the package installation.

WARNING

Wenn Sie Software für das Pooling von Datenbankverbindungen wie PgBouncer verwenden, stellen Sie sicher, dass Sie einen Pooling-Modus verwenden, der vollständig mit PostgreSQL kompatibel ist. Typischerweise wird dies "session connection pooling" genannt. Transaktionsbasiertes connection pooling wird nicht unterstützt und kann bei Datenbankmigrationen zu Fehlern führen.

Reverse Proxy

Die folgenden Reverse-Proxys werden unterstützt:

• Nginx 1.3+
• Apache 2.2+

Das Installationsskript versucht, während der Installation einen Apache oder Nginx zu erkennen. Falls keiner gefunden wird, wird automatisch Nginx installiert. Eine Grundkonfiguration finden Sie in unserem Webserver-Tutorial.

Elasticsearch optional dringend empfohlen

Elasticsearch wird nicht automatisch installiert. Da es für eine ordnungsgemäße Einrichtung von Zammad entscheidend ist, ist es in den obigen Installationsanweisungen enthalten. Wenn Sie Zammad mit einer bereits existierenden Elasticsearch-Instanz verbinden wollen, stellen Sie sicher, dass Sie eine unterstützte Version verwenden und werfen Sie einen Blick auf unser Beispiel-Konfiguration.

Unterstützte Elasticsearch-Versionen sind 7.8 - 8.x.

Elasticsearch version history

Zammad	Elasticsearch
5.2+	>= 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

Das Elasticsearch-Plugin ingest-attachment wird für Version 7 oder älter benötigt, um den Inhalt von E-Mail-Anhängen zu indizieren. Ab Elasticsearch 8 ist es standardmäßig in der Installation enthalten.

Memcached

Zammad verwendet ausgiebig Caching, um die Leistung zu verbessern. Dieser Cache kann im Dateisystem gespeichert werden, ohne auf externe Dienste angewiesen zu sein. Dies ist jedoch nur möglich, wenn alle Dienste von Zammad auf demselben Dateisystem laufen!

In allen anderen Fällen, wie der Bereitstellung von Zammad über Container (Docker oder Kubernetes) oder auf separaten Clusterknoten, ist ein Memcached-Dienst erforderlich, um den Cache zu speichern und ihn allen Zammad-Instanzen zur Verfügung zu stellen. Die Docker- und Kubernetes-Stacks enthalten diesen Dienst bereits.

Aber auch lokale Dateisysteminstallationen können von den Leistungsverbesserungen von Memcached profitieren. Sie sollten auch einen Blick auf unseren Abschnitt Leistungsoptimierung werfen.

Die Installation und Konfiguration ist nicht Gegenstand dieser Dokumentation. Falls Sie Memcached manuell installieren müssen, folgen Sie bitte der offiziellen Dokumentation von Memcached.

GnuPG optional

Wenn Sie die PGP-Integration zum Senden und Empfangen von signierten und verschlüsselten E-Mails nutzen möchten, müssen Sie das GnuPG-Tool installieren. Bitte werfen Sie einen Blick auf die offizielle GnuPG-Website.