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.

A partir do Zammad 7, os pacotes estão sendo construídos usando uma nova cadeia de ferramentas e hospedados em outra URL. Os pacotes também continuam sendo construídos pela cadeia de ferramentas antiga (exceto para Debian 13) por algum tempo, mas recomendamos que você mude para os novos repositórios em tempo hábil. Isso significa que você precisa adicionar uma nova chave de repositório e alterar a configuração do seu repositório.

WARNING

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

Os seguintes sistemas operacionais são suportados:

Distribution	Version
CentOS/RHEL	9, 10
Debian	11, 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.

O Packager.io pode não estar acessível a partir de ambientes somente IPv6, então certifique-se de considerar isso ao realizar as etapas abaixo. :::

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

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