Zammad na VPS: central de chamados no seu servidor
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

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.