Base de Conhecimento

Zammad na VPS: central de chamados no seu servidor

  • zammad, helpdesk, central de chamados, elasticsearch, vps
  • Usuários acharam útil: 0

Zammad na VPS: licença AGPL, requisitos de memória, instalação por pacote no Ubuntu com Elasticsearch, Nginx com HTTPS e Certbot, Docker Compose em resumo, backup e atualização.

Por Redação Eleven Host · @robson.direitodigital · 11 de novembro de 2026 · 11 min de leitura

Arte da Eleven Host: janela de terminal com o título: Zammad na VPS: central de chamados no seu servidor

Capa da Redação Eleven Host para o guia: Zammad na VPS: central de chamados no seu servidor Arte: Eleven Host

Zammad na VPS é a forma de manter a central de chamados Zammad, um helpdesk de código aberto, no seu próprio servidor Ubuntu. Veja a licença, os requisitos de memória, a instalação por pacote com Elasticsearch, o Nginx com HTTPS, o backup e a atualização.

Atualizado em 11/11/2026. Em 11/11/2026, a versão mais nova na página de releases do Zammad é a 7.2.3, uma atualização de segurança. Os blocos de comando abaixo são exemplos: confira cada um no seu servidor antes de usar.

O que é o Zammad e quando vale hospedar

O Zammad é um sistema de chamados: as mensagens dos clientes chegam por vários canais e a equipe responde tudo num só lugar. No GitHub, a licença do projeto aparece como AGPL-3.0, e o README fala da GNU Affero General Public License v3. O fabricante afirma que o software é e continuará sendo de código aberto.

Pelo sumário da documentação de administração, entre os canais estão Web, Form, e-mail, chat, Google Email, Microsoft 365, SMS, Facebook e Telegram. O guia completo de servidor VPS explica o que é uma VPS.

Hospedar o Zammad no próprio servidor faz sentido quando a empresa quer os chamados num ambiente que ela controla. O preço é a responsabilidade: segundo o fabricante, quem hospeda cuida de atualizações, backups e disponibilidade. Ele também vende uma versão na nuvem, cobrada por agente, e contratos de suporte para quem hospeda. Se a equipe não quer cuidar de servidor, a nuvem do fabricante é uma opção a avaliar.

Requisitos oficiais: a memória é alta

A documentação de hardware pede no mínimo 2 núcleos de CPU e 6 GB de RAM, e mais 4 GB se o Elasticsearch rodar no mesmo servidor. No exemplo para até 40 agentes, são 6 núcleos e 6 GB, mais 6 GB com o Elasticsearch junto. Para disco, o fabricante não dá número, porque depende de como a equipe trabalha. Com 5 ou mais agentes, ele orienta revisar as variáveis de ambiente e o servidor de banco.

O pacote oficial vale para Ubuntu 22.04, 24.04 e 26.04. O banco é PostgreSQL 15 ou mais novo e o Redis, o 7 ou mais novo: o pacote instala os dois se faltarem. O Elasticsearch é opcional, mas fortemente recomendado; para o Zammad 7.2 ou mais novo, vai da 8.15 até antes da 10. O servidor web pode ser Nginx ou Apache. Confira que o sistema da sua VPS é um desses.

Para dimensionar o servidor, o guia Quanta RAM precisa uma VPS mostra como fazer a conta.

Requisitos oficiais na mão, a comparação entre planos de VPS fica mais direta. Confira na loja o que cada plano inclui. Ver as VPS

Instalação por pacote no Ubuntu, na ordem certa

O caminho completo abaixo é o do pacote oficial, com sudo como na documentação.

O Elasticsearch entra antes do Zammad, e a senha do usuário elastic aparece só na saída da instalação dele: copie na hora.

Primeiro, as ferramentas básicas. Um exemplo de comando:

sudo apt update && sudo apt install curl apt-transport-https gnupg

Depois, o locale. Confira se o idioma é UTF-8:

locale | grep "LANG="

Se não aparecer um idioma terminado em .utf8, gere o en_US.UTF-8 e grave como padrão; confira de novo e, se continuar errado, reinicie:

sudo apt install locales

sudo locale-gen en_US.UTF-8

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

Elasticsearch 9 antes do Zammad

A documentação usa o repositório oficial do Elasticsearch 9:

curl -fsSL https://artifacts.elastic.co/GPG-KEY-elasticsearch | gpg --dearmor | sudo tee /usr/share/keyrings/elasticsearch-keyring.gpg && sudo chmod 644 /usr/share/keyrings/elasticsearch-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/elasticsearch-keyring.gpg] https://artifacts.elastic.co/packages/9.x/apt stable main" | sudo tee /etc/apt/sources.list.d/elastic-9.x.list

A saída da instalação mostra a senha do superusuário elastic. Copie e guarde na hora:

sudo apt update && sudo apt install elasticsearch

A documentação recomenda acrescentar http.max_content_length: 400mb ao /etc/elasticsearch/elasticsearch.yml. Depois, habilite o serviço:

sudo systemctl enable elasticsearch.service --now

Instalar o Zammad

Com o Elasticsearch no ar, baixe a chave do repositório do Zammad:

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

Escolha o repositório da sua versão do Ubuntu. Para o 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

Para o 24.04 ou o 26.04, o comando é o mesmo, trocando o final por ubuntu/24.04.list ou ubuntu/26.04.list. O Packager.io pode não abrir em ambiente só com IPv6. Depois, a instalação:

sudo apt update

sudo apt install zammad

O pacote cria os serviços zammad-web, zammad-worker e zammad-websocket, controlados pelo serviço pai: sudo systemctl start zammad, com stop, restart e status. Se usa o UFW, a documentação libera as portas 80 e 443; confira que a porta do seu acesso SSH continua liberada:

sudo ufw allow 80

sudo ufw allow 443

Ligar o Zammad ao Elasticsearch

Só agora o Zammad conhece o Elasticsearch. A documentação os mostra sem sudo; recomendamos usá-lo antes de cada zammad run, também depois da barra vertical. Troque <senha> pela senha do elastic que você guardou:

sudo zammad run rails r "Setting.set('es_url', 'https://localhost:9200')"

sudo zammad run rails r "Setting.set('es_user', 'elastic')"

sudo zammad run rails r "Setting.set('es_password', '<senha>')"

Em seguida, o certificado do Elasticsearch entra no Zammad e o índice é reconstruído. O prefixo zammad run vale só para a instalação por pacote:

sudo cat /etc/elasticsearch/certs/http_ca.crt | sudo zammad run rails r 'SSLCertificate.create!(certificate: STDIN.read)'

sudo zammad run rake zammad:searchindex:rebuild

Nginx e HTTPS com Certbot

A documentação diz que o Zammad exige HTTPS em produção. O pacote deixa um zammad.conf sem SSL que não deve ser usado em produção; a troca é pelo modelo com SSL. Antes, aponte o DNS do domínio para o IP da VPS, porque o Let's Encrypt só emite o certificado se o nome chegar ao servidor. Para domínios registrados conosco, o DNS gerenciado grátis na rede da Cloudflare fica no painel da área do cliente. Se o Nginx não estiver instalado, um exemplo de comando é sudo apt install nginx.

Primeiro, o certificado, antes de trocar o zammad.conf, para o Nginx ainda ter uma configuração válida. Com o Certbot e o plugin do Nginx instalados (o guia Certbot na VPS: SSL grátis do Let's Encrypt no Nginx mostra como), emita só o certificado. Um exemplo, com o domínio fictício:

sudo certbot certonly --nginx -d chamados.exemplo.com

Copie o modelo oficial para a pasta do Nginx:

sudo cp /opt/zammad/contrib/nginx/zammad_ssl.conf /etc/nginx/sites-available/zammad.conf

Abra o arquivo e troque o example.com dos DOIS server_name, o da porta 80 e o da 443, pelo seu domínio, como chamados.exemplo.com, e aponte ssl_certificate, ssl_certificate_key e ssl_trusted_certificate para fullchain.pem, privkey.pem e chain.pem em /etc/letsencrypt/live/chamados.exemplo.com/. Confira se o arquivo tem link em /etc/nginx/sites-enabled/, pois sem ele o Nginx não o carrega. O teste e o recarregamento:

sudo nginx -t

sudo systemctl restart nginx

A documentação usa o certbot --nginx e manda escolher a opção 1, not redirect, se ele perguntar sobre redirecionamento, porque o modelo do Zammad já redireciona. Com o certonly acima, essa pergunta não aparece.

O Zammad escuta na porta 3000 (aplicação) e na 6042 (websocket), e a documentação avisa para não o expor direto à internet: o acesso externo passa pelo Nginx.

Primeiro acesso: o assistente na web

Com o HTTPS no ar, abra o endereço no navegador: na primeira visita, o Zammad abre o assistente. Recomendamos concluí-lo logo depois de subir o HTTPS, para que o primeiro administrador seja você.

  • Administrador: a senha padrão exige 10 ou mais caracteres, com 2 maiúsculas, 2 minúsculas e 1 dígito.
  • Empresa: dados e logo. O endereço da instância é detectado sozinho.
  • Notificações: o Zammad usa o sendmail por padrão; dá para trocar por SMTP.
  • Caixa de e-mail (opcional): o Zammad reage por padrão aos e-mails buscados; se não é o que você quer, pule por enquanto.

Docker Compose em resumo

No repositório zammad-docker-compose, a documentação pede Docker Compose 2.23.1 ou mais novo, 4 GB de RAM livres e o ajuste de vm.max_map_count para o Elasticsearch. Um exemplo, com o Docker já instalado (se o seu usuário não está no grupo docker, use sudo antes de docker):

sudo sysctl -w vm.max_map_count=262144

git clone https://github.com/zammad/zammad-docker-compose.git

cd zammad-docker-compose

docker compose up -d

O sysctl -w vale até o próximo reinício; confira se o valor continua depois. O banco usa zammad como senha padrão (POSTGRES_PASS); recomendamos trocá-la antes do primeiro up. Para a internet, a documentação exige HTTPS e sugere proxy reverso, como o Nginx Proxy Manager com Let's Encrypt, ou túnel da Cloudflare. O fabricante não dá suporte a problemas específicos de Docker Compose.

Backup e restauração

No pacote, os scripts ficam em /opt/zammad/contrib/backup. Para configurar, renomeie o arquivo de exemplo e rode o backup com sudo (a documentação aceita root ou o usuário zammad). Um exemplo de comandos:

cd /opt/zammad/contrib/backup/

sudo mv config.dist config

sudo /opt/zammad/contrib/backup/zammad_backup.sh

Por padrão, o backup vai para /var/tmp/zammad_backup e guarda 10 dias. As variáveis de ambiente do sistema ficam fora dele. Recomendamos agendar o script no cron do root e testar uma restauração.

Para restaurar, rode o script interativo como root. Ele para o Zammad, apaga e recria o banco e pede espaço livre de pelo menos o dobro do backup. Depois, religue o Elasticsearch e reconstrua o índice. Restaurar numa versão mais antiga do Zammad não é possível.

sudo /opt/zammad/contrib/backup/zammad_restore.sh

No Docker, os scripts do pacote não funcionam: a pilha tem o serviço zammad-backup, que por padrão faz backup às 3 da manhã. Um exemplo de backup avulso:

docker compose run --rm --env BACKUP_ONCE=true zammad-backup

Onde guardar o backup

O backup inclui chamados, anexos e dados de clientes. Recomendamos copiá-lo para fora do servidor, em local protegido.

Atualizar sem pular versão major

A documentação diz para não pular versões major e para ler as release notes antes. No pacote, a sequência oficial é parar o Zammad, fazer o backup (o da seção anterior, depois do primeiro comando abaixo) e atualizar em duas etapas, porque atualizar Zammad e banco juntos pode falhar:

sudo systemctl stop zammad

sudo apt update

sudo apt-mark hold zammad

sudo apt upgrade

sudo apt-mark unhold zammad

sudo apt upgrade

No Compose, são git pull, docker compose pull e docker compose up -d.

Dados pessoais dos clientes

Chamados podem guardar nome, e-mail e conversas. A documentação descreve tarefas de exclusão que removem um usuário e os chamados dele como cliente, e diz que isso pode ser necessário para o GDPR e outras leis de privacidade. Não dá para apagar só o usuário e manter os chamados, e toda exclusão é definitiva.

A LGPD é a lei brasileira de proteção de dados. A documentação fala só de GDPR, e uma ferramenta não garante conformidade sozinha: recomendamos tratar o assunto com quem cuida do jurídico da empresa.

Dimensionar o servidor do Zammad

A memória somada do Zammad e do Elasticsearch é o ponto de partida.

Uma página da loja reúne as VPS da Eleven Host. Confira na loja o que cada plano inclui. Conhecer as VPS

Perguntas frequentes

O Zammad é gratuito?

A licença é a AGPL-3.0, então o software é de código aberto. Quem hospeda cuida de atualizações, backups e disponibilidade.

O Elasticsearch é obrigatório?

Não. A documentação o chama de opcional, mas fortemente recomendado. Se for usar, instale antes do Zammad.

Perdi a senha do usuário elastic. E agora?

A documentação indica /usr/share/elasticsearch/bin/elasticsearch-reset-password -u elastic para redefinir. Atualize a senha no Zammad.

Posso pular da versão 6 para a 7.2?

A documentação diz para não pular versões major. Leia as release notes e faça backup antes.

Esta resposta lhe foi útil?

Artigos Relacionados