Instalação via pacote

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!

Sistemas operacionais suportados

Para instalação via pacote, as seguintes distribuições Linux são suportadas:

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

Se sua distribuição não for suportada, sinta-se à vontade para usar outro método de instalação, ou considere usar o serviço de nuvem do Zammad.

Para seguir as etapas de instalação abaixo, ferramentas como curl, gnupg e outras são necessárias. Se elas não estiverem presentes no seu sistema, instale-as:

sudo apt install curl apt-transport-https gnupg

Fundamentos

Garantir a localidade correta

Liste suas configurações de localidade atuais:

locale | grep "LANG="

Se o comando acima não retornar <lang_code>.utf8, você pode corrigir esse problema da seguinte forma:

sudo apt install locales

sudo locale-gen en_US.UTF-8

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

Depois de corrigir, certifique-se de verificar a saída novamente para incluir <lang_code>.utf8. Uma reinicialização pode ajudar se não for bem-sucedido.

Instalar o Elasticsearch

O método recomendado é usar o guia oficial da Elastic para instalar o Elasticsearch.

Como alternativa, você pode seguir nosso exemplo de configuração do Elasticsearch 9, que é separado para manter as instruções de instalação o mais simples possível.

Adicionar repositório do Zammad

INFO

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

Gerenciar os serviços do Zammad

O Zammad usa três serviços. Esses serviços podem ser gerenciados individualmente ou todos de uma vez usando o serviço pai zammad.

• zammad: inclui os serviços abaixo
  • zammad-web: servidor puma interno (relevante para exibir a aplicação web)
  • zammad-worker: worker em segundo plano - relevante para todas as tarefas atrasadas e em segundo plano
  • zammad-websocket: servidor WebSocket para informações relacionadas à sessão

Gerencie os serviços com os comandos start, restart, stop, status do systemctl.

Exemplo para iniciar o Zammad com todos os subserviços:

sudo systemctl start zammad

Para parar ou reiniciar um serviço, ou verificar seu status, ajuste o comando conforme mencionado acima.

Próximas etapas

• Conectar o Zammad ao Elasticsearch
• Ajustar suas regras do SELinux e firewall
• Configurar o servidor web

Dependências

Assumindo um sistema limpo, as seguintes dependências serão automaticamente instaladas durante a instalação do pacote Zammad. Além disso, você pode encontrar algumas informações sobre o Elasticsearch abaixo, que não é instalado automaticamente.

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

Servidor de banco de dados

O Zammad armazena seu conteúdo em um banco de dados. O sistema de banco de dados suportado é o PostgreSQL 15 ou mais recente. Se nenhum servidor PostgreSQL for detectado, ele será instalado automaticamente durante a instalação do pacote.

WARNING

Se você usa um software de pooling de conexão de banco de dados como o PgBouncer, certifique-se de usar um modo de pooling totalmente compatível com o PostgreSQL. Normalmente, isso é chamado de "session connection pooling". O pooling de conexão baseado em transação não é suportado e pode levar a erros durante as migrações de banco de dados.

Proxy reverso

Os seguintes proxies reversos são suportados em suas versões atualmente mantidas:

• Nginx
• Apache

O script de instalação tenta detectar um Apache ou Nginx durante a instalação. Caso nenhum seja encontrado, o Nginx é instalado automaticamente. Você pode encontrar um exemplo básico no nosso guia de configuração de servidor web.

Redis

O Redis é necessário para comunicação em tempo real via web socket. O Zammad requer o Redis 7 ou mais recente. Ele é instalado automaticamente (pacote) ou incluído na stack (Docker Compose) com uma configuração funcional. No entanto, a instalação e configuração estão fora do escopo desta documentação. Siga os guias oficiais e certifique-se de configurá-lo de forma segura.

As variáveis de ambiente disponíveis para configurações padrão e Sentinel são brevemente mencionadas na página de Variáveis do Redis.

INFO

O CentOS e o RHEL 10 usam o Valkey como substituto direto do Redis. Durante a instalação do Zammad nessas distribuições, ele é instalado automaticamente como dependência.

Elasticsearch optional highly recommended

O Elasticsearch não é instalado automaticamente. Como é crucial para uma configuração adequada do Zammad, ele está incluído nas instruções de instalação acima. Se você quiser conectar o Zammad a uma instância já existente do Elasticsearch, certifique-se de usar uma versão suportada e dê uma olhada no nosso exemplo de configuração.

As versões suportadas do Elasticsearch são 8.11 - 9.x.

Histórico de versões do Elasticsearch para o Zammad:

Details

Zammad	Elasticsearch
7.2+	>= 8.11, <10
7.0-7.1	>= 7.8, <10
5.2-6.5	>= 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

Memcached

O Zammad depende muito de cache para melhorar o desempenho. Esse cache pode ser armazenado no sistema de arquivos, sem depender de serviços externos. No entanto, isso só é possível se todos os serviços do Zammad estiverem sendo executados no mesmo sistema de arquivos!

Em todos os outros casos, como implantar o Zammad via containers (Docker ou Kubernetes) ou em nós de cluster separados, um serviço Memcached é necessário para armazenar o cache e disponibilizá-lo para todas as instâncias do Zammad. As stacks do Docker e Kubernetes já incluem esse serviço.

No entanto, mesmo instalações em sistema de arquivos local podem se beneficiar das melhorias de desempenho do Memcached. Talvez você queira dar uma olhada na nossa seção de ajuste de desempenho também.

A instalação e configuração estão fora do escopo desta documentação. Caso você precise instalar o Memcached manualmente, siga a documentação oficial do Memcached.

GnuPG optional

Se você quiser usar a integração PGP para enviar e receber emails assinados e criptografados, precisa instalar a ferramenta GnuPG. Dê uma olhada no site oficial do GnuPG.