Host Upgrade and Repository Migration

TIP

Да ли сте преуморни од комплексних поставки, подешавања, резервних копија и ажурирања? Дозволите нам да вам помогнемо око тога! 🚀

Најлакши и најчешће најјефтинији начин да имплементирате Zаmmad је наш сервис у облаку. Уверите се преко бесплатне пробне инстанце!

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

Always make sure to have a backup of your data before performing an upgrade.

The following operating systems are supported:

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

Stop Zammad

sudo systemctl stop zammad

Host Upgrade Steps

Disable Updates for Zammad

sudo apt-mark hold zammad

Perform Host Upgrade

Perform the host upgrade according to the documentation of your operating system. Because this is an advanced task, we don't provide detailed steps here. After upgrading your operating system, proceed with the next steps.

Reboot Host

In case you did not reboot your system after the upgrade, make sure to reboot your system now. Afterwards, check if everything is running as expected. In case Zammad starts automatically, stop it again before proceeding with the next steps.

Adjust Package Repository

Remove Old Repository

Remove the old repository configuration file or disable/delete the old repository in your package manager.

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

Add New Repository

If the repository key is different for the old and new version your distribution or your distribution expects it in a different location, add the new one. Otherwise, you can add the new repository configuration directly.

:::

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-а

sudo apt update

sudo apt install zammad

Управљање Zammad сервисима

Update Zammad

TIP

If there is a new Zammad version available and you want to update to it, check the release notes for any required additional steps.

Re-enable updates for Zammad and update Zammad to the latest version available for your operating system.

Update package index:

sudo apt update

Re-enable updates for Zammad:

sudo apt-mark unhold zammad

Update Zammad:

sudo apt upgrade zammad

Start Zammad

sudo systemctl start zammad