Host Upgrade and Repository Migration

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!

This page covers the required steps for a host upgrade and to switch to Zammad's new package repositories. If you just want to update Zammad itself, please refer to Updating Zammad. To just switch to the new repositories without a host upgrade, skip the host upgrade steps.

Starting with Zammad 7, packages are being built using a new toolchain and hosted under another URL. The packages are being built via old toolchain as well (except for Debian 13) for some time, but we encourage you to switch to the new repositories in a timely manner. This means you need to add a new repository key and change your repository configuration.

WARNING

Stellen Sie immer sicher, dass Sie eine Sicherung Ihrer Daten haben, bevor Sie ein Upgrade durchführen.

Die folgenden Betriebssysteme werden unterstützt:

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

Zammad stoppen

sudo systemctl stop zammad

Host Upgrade Steps

Aktualisierungen für Zammad deaktivieren

sudo apt-mark hold zammad

Host-Upgrade durchführen

Führen Sie das Host-Upgrade gemäß der Dokumentation Ihres Betriebssystems durch. Da es sich hierbei um eine anspruchsvolle und umfangreiche Aufgabe handelt, gibt es dazu hier keine Anleitung. Nach dem Upgrade Ihres Betriebssystems fahren Sie mit den nächsten Schritten fort.

Host neu starten

Falls Sie Ihr System nach dem Upgrade nicht neu gestartet haben, müssen Sie es jetzt neu starten. Prüfen Sie anschließend, ob alles wie erwartet läuft. Falls Zammad automatisch startet, stoppen Sie es wieder, bevor Sie mit den nächsten Schritten fortfahren.

Paketquelle anpassen

Alte Paketquelle entfernen

Entfernen Sie die alte Konfigurationsdatei der Paketquelle oder deaktivieren/löschen Sie die alte Paketquelle in Ihrem Paketmanager.

Ubuntu 22.04:

sudo rm /etc/apt/sources.list.d/zammad.sources

Ubuntu 24.04:

sudo rm /etc/apt/sources.list.d/zammad.list

Remove Old Repository Key

Remove the old repository key from your system. Depending on your operating system and version, the location or method differs.

sudo rm /etc/apt/keyrings/pkgr-zammad.gpg

Neue Paketquelle hinzufügen

Wenn der Paketquellen-Schlüssel für die alte und die neue Version Ihrer Distribution unterschiedlich ist oder Ihre Distribution diesen an einem anderen Ort erwartet, fügen Sie den neuen Schlüssel hinzu. Andernfalls können Sie direkt die neue Konfiguration der Paketquelle 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.

Install repository key:

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

Add 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

Add 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

Zammad installieren

sudo apt update

sudo apt install zammad

Aktivieren Sie die Updates für Zammad wieder und aktualisieren Sie Zammad auf die neueste Version, die für Ihr Betriebssystem verfügbar ist.

Update package index:

sudo apt update

Re-enable updates for Zammad:

sudo apt-mark unhold zammad

Update Zammad:

sudo apt upgrade zammad

Zammad starten

sudo systemctl start zammad