Atualização de host e migração de repositório

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!

Esta página cobre as etapas necessárias para uma atualização de host e para mudar para os novos repositórios de pacotes do Zammad. Se você só quer atualizar o próprio Zammad, consulte Atualizando o Zammad. Para apenas mudar para os novos repositórios sem uma atualização de host, pule as etapas de atualização de host.

Zammad packages are being built with a new toolchain and are hosted under another URL. The old toolchain is no longer in use, so the packages in the old repositories no longer receive updates. This means you need to add a new repository key and change your repository configuration.

The repository channel in the URL selects the release line: stable contains the current stable release, while release lines that are out of support have a channel of their own, for example stable-6.5.

WARNING

Sempre se certifique de ter um backup dos seus dados antes de realizar uma atualização.

WARNING

Zammad 6.5.5 is an emergency release that fixes a security issue. Zammad 6.5 is out of support and its packages are only available in the stable-6.5 channel. See Update an out-of-support release below for the steps.

Os seguintes sistemas operacionais são suportados:

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

Parar o Zammad

sudo systemctl stop zammad

Etapas de atualização de host

Desativar atualizações para o Zammad

sudo apt-mark hold zammad

Realizar a atualização de host

Realize a atualização de host de acordo com a documentação do seu sistema operacional. Como esta é uma tarefa avançada, não fornecemos etapas detalhadas aqui. Depois de atualizar seu sistema operacional, prossiga com as próximas etapas.

Reiniciar o host

Caso você não tenha reiniciado seu sistema após a atualização, certifique-se de reiniciá-lo agora. Depois, verifique se tudo está funcionando como esperado. Caso o Zammad inicie automaticamente, pare-o novamente antes de prosseguir com as próximas etapas.

Ajustar o repositório de pacotes

Remover repositório antigo

Remova o arquivo de configuração do repositório antigo ou desative/exclua o repositório antigo no seu gerenciador de pacotes.

Ubuntu 22.04:

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

Ubuntu 24.04:

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

Remover chave de repositório antiga

Remova a chave de repositório antiga do seu sistema. Dependendo do seu sistema operacional e versão, o local ou método é diferente.

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

Adicionar novo repositório

Se a chave de repositório for diferente para a versão antiga e nova, ou se sua distribuição espera que ela esteja em outro local, adicione a nova. Caso contrário, você pode adicionar a nova configuração de repositório diretamente.

Adicione a chave do repositório:

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

Adicione o repositório (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

Adicione o repositório (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

Adicione o repositório (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

Instalar o Zammad

sudo apt update

sudo apt install zammad

Atualizar o Zammad

TIP

Se houver uma nova versão do Zammad disponível e você quiser atualizá-la, verifique as notas de lançamento para quaisquer etapas adicionais necessárias.

Reative as atualizações do Zammad e atualize-o para a versão mais recente disponível para o seu sistema operacional.

Atualizar índice de pacotes:

sudo apt update

Reativar atualizações para o Zammad:

sudo apt-mark unhold zammad

Atualizar o Zammad:

sudo apt upgrade zammad

Iniciar o Zammad

sudo systemctl start zammad

Update an out-of-support release

Zammad 6.5.5 is an emergency release that fixes a security issue. Zammad 6.5 has been out of support for some time and no longer receives security updates, so updating to the current stable release is the recommended action. Follow the steps below only if you cannot update to a supported release right now.

Zammad builds 6.5.5 packages for Ubuntu 20.04, 22.04 and 24.04, Debian 11 and 12, CentOS/RHEL 8 and 9, and OpenSUSE Leap/SLES 15.

Add the 6.5 repository

Remove the old repository and its key first, as described in Adjust package repository above. Otherwise your package manager keeps reading the old repository, which offers packages of a newer release line.

Add the new repository with the stable-6.5 channel:

Add 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 20.04):

sudo curl -fsSL "https://go.packager.io/srv/zammad/zammad/stable-6.5/installer/ubuntu/20.04.list" \
  -o /etc/apt/sources.list.d/zammad.list

Add repository (Ubuntu 22.04):

sudo curl -fsSL "https://go.packager.io/srv/zammad/zammad/stable-6.5/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-6.5/installer/ubuntu/24.04.list" \
  -o /etc/apt/sources.list.d/zammad.list

Update Zammad to 6.5.5

Stop Zammad:

sudo systemctl stop zammad

Atualizar índice de pacotes:

sudo apt update

Reativar atualizações para o Zammad:

sudo apt-mark unhold zammad

Atualizar o Zammad:

sudo apt upgrade zammad

Start Zammad:

sudo systemctl start zammad