Instalação Zammad · 6 min read · Oct 19, 2025

Como Instalar o Sistema de Chamadas Zammad no Ubuntu 22.04

Zammad é uma solução de suporte/chamadas gratuita, de código aberto e baseada na web, usada para gerenciar a comunicação com o cliente. Você pode conectá-lo através de vários canais, como e-mail, chat, telefone, Twitter ou Facebook. É escrito nas linguagens de programação JavaScript e Ruby. Ele suporta REST API que ajuda você a vincular outros programas facilmente e obter informações em tempo real sobre todos os seus canais e operações. O Zammad oferece recursos muito úteis, incluindo integração LDAP, registro de tempo, integração com Slack, SSO, Multilinguismo e muito mais.

Neste post, mostraremos como instalar o sistema de chamadas Zammad no servidor Ubuntu 22.04.

Requisitos

  • Um servidor rodando Ubuntu 22.04.
  • Uma senha de root configurada em seu servidor.

Atualizar o Sistema

Primeiro, você precisará atualizar e fazer upgrade de todos os pacotes do seu sistema para a versão mais recente. Você pode atualizar todos eles executando o seguinte comando.

apt update -y   
apt upgrade -y

Uma vez que todos os pacotes do sistema estejam atualizados, você pode prosseguir para o próximo passo.

Instalar Java JDK

Primeiro, você precisará instalar o Java OpenJDK em seu servidor. Você pode instalá-lo com o seguinte comando.

apt install openjdk-17-jdk -y

Uma vez que o Java esteja instalado, você pode verificar a versão do Java usando o seguinte comando.

java -version

Você deve ver a versão do Java na seguinte saída.

openjdk version "17.0.5" 2022-10-18
OpenJDK Runtime Environment (build 17.0.5+8-Ubuntu-2ubuntu122.04)
OpenJDK 64-Bit Server VM (build 17.0.5+8-Ubuntu-2ubuntu122.04, mixed mode, sharing)

Uma vez que o Java esteja instalado, você pode prosseguir para instalar o ElasticSearch.

Instalar ElasticSearch

O Zammad usa o ElasticSearch para fornecer funcionalidade de busca. Portanto, você precisará instalar o ElasticSearch em seu servidor. Por padrão, o pacote ElasticSearch não está incluído no repositório padrão do Ubuntu. Portanto, você precisará adicionar o repositório do ElasticSearch ao seu servidor.

Primeiro, instale as dependências necessárias usando o seguinte comando.

apt install gnupg2 curl -y

Em seguida, adicione a chave GPG do ElasticSearch e o repositório ao APT com o seguinte comando.

curl -fsSL https://artifacts.elastic.co/GPG-KEY-elasticsearch | gpg --dearmor -o /usr/share/keyrings/elastic.gpg  
echo "deb [signed-by=/usr/share/keyrings/elastic.gpg] https://artifacts.elastic.co/packages/7.x/apt stable main" | tee -a /etc/apt/sources.list.d/elastic-7.x.list

Em seguida, atualize o cache do repositório com o seguinte comando.

apt update -y

Finalmente, instale o pacote ElasticSearch usando o seguinte comando.

apt install elasticsearch -y

Uma vez que o ElasticSearch esteja instalado, inicie e habilite o serviço ElasticSearch com o seguinte comando.

systemctl enable elasticsearch.service  
systemctl start elasticsearch.service

Agora você pode verificar o ElasticSearch com o seguinte comando.

curl -X GET 'http://localhost:9200'

Se tudo estiver bem, você obterá a seguinte saída.

{
  "name" : "ubuntu2204",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "V4bBWciDSSWmI-QcwvJdGA",
  "version" : {
    "number" : "7.17.8",
    "build_flavor" : "default",
    "build_type" : "deb",
    "build_hash" : "120eabe1c8a0cb2ae87cffc109a5b65d213e9df1",
    "build_date" : "2022-12-02T17:33:09.727072865Z",
    "build_snapshot" : false,
    "lucene_version" : "8.11.1",
    "minimum_wire_compatibility_version" : "6.8.0",
    "minimum_index_compatibility_version" : "6.0.0-beta1"
  },
  "tagline" : "Você Sabe, para Busca"
}

Você também precisará instalar o plugin ingest-attachment. Você pode instalá-lo com o seguinte comando.

/usr/share/elasticsearch/bin/elasticsearch-plugin install ingest-attachment

Você receberá a seguinte saída.

-> Instalando ingest-attachment
-> Baixando ingest-attachment do elastic
[=================================================] 100%   
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@     AVISO: o plugin requer permissões adicionais     @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
* java.lang.RuntimePermission accessClassInPackage.sun.java2d.cmm.kcms
* java.lang.RuntimePermission accessDeclaredMembers
* java.lang.RuntimePermission getClassLoader
* java.lang.reflect.ReflectPermission suppressAccessChecks
* java.security.SecurityPermission createAccessControlContext
Veja https://docs.oracle.com/javase/8/docs/technotes/guides/security/permissions.html
para descrições do que essas permissões permitem e os riscos associados.

Continuar com a instalação? [y/N]y
-> Instalado ingest-attachment
-> Por favor, reinicie o Elasticsearch

Em seguida, reinicie o serviço ElasticSearch para aplicar as alterações.

systemctl restart elasticsearch

Uma vez que você tenha terminado, pode prosseguir para instalar o Apache e outras dependências.

Instalar Apache e Outras Dependências

Primeiro, instale o pacote do servidor web Apache usando o seguinte comando.

apt install apache2 -y

Em seguida, você também precisará instalar o libssl em seu servidor. Primeiro, adicione o repositório de segurança Focal com o seguinte comando.

echo "deb http://security.ubuntu.com/ubuntu focal-security main" | tee /etc/apt/sources.list.d/focal-security.list

Em seguida, atualize o repositório e instale o pacote libssl com o seguinte comando.

apt update -y  
apt install libssl1.1

Uma vez que você tenha terminado, pode prosseguir para instalar o Zammad na etapa.

Instalar o Sistema de Chamadas Zammad

Por padrão, o pacote Zammad não está incluído no repositório do Ubuntu. Portanto, você precisará adicionar o repositório do Zammad ao seu servidor.

Primeiro, adicione a chave GPG do Zammad com o seguinte comando.

curl -fsSL https://dl.packager.io/srv/zammad/zammad/key | gpg --dearmor | tee /etc/apt/trusted.gpg.d/pkgr-zammad.gpg> /dev/null

Em seguida, adicione o repositório do Zammad ao APT com o seguinte comando.

echo "deb [signed-by=/etc/apt/trusted.gpg.d/pkgr-zammad.gpg] https://dl.packager.io/srv/deb/zammad/zammad/stable/ubuntu 22.04 main"| tee /etc/apt/sources.list.d/zammad.list

Em seguida, atualize o cache do repositório usando o seguinte comando.

apt update -y

Agora, instale o pacote Zammad com o seguinte comando.

apt install zammad -y

Uma vez que o Zammad esteja instalado, você pode prosseguir para o próximo passo.

Configurar o Apache para Zammad

O Zammad cria um arquivo de configuração do Apache automaticamente no diretório de configuração do Apache. No entanto, você precisará editar o arquivo de configuração do Zammad e modificá-lo conforme sua necessidade.

nano /etc/apache2/sites-available/zammad.conf

Altere as seguintes linhas.

#ServerTokens Prod
    ServerName seu-ip-do-servidor
    #RequestHeader unset X-Forwarded-User

Salve e feche o arquivo, então desative o arquivo de configuração padrão do Apache.

a2dissite 000-default.conf

Em seguida, reinicie o serviço Apache para aplicar as alterações.

systemctl restart apache2

Agora você pode verificar o status do Apache com o seguinte comando.

systemctl status apache2

Você deve obter a seguinte saída.

? apache2.service - O Servidor HTTP Apache
     Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
     Active: active (running) since Fri 2022-12-30 02:49:21 UTC; 8s ago
       Docs: https://httpd.apache.org/docs/2.4/
    Process: 13887 ExecStart=/usr/sbin/apachectl start (code=exited, status=0/SUCCESS)
   Main PID: 13891 (apache2)
      Tasks: 55 (limit: 4579)
     Memory: 5.1M
        CPU: 53ms
     CGroup: /system.slice/apache2.service
             ??13891 /usr/sbin/apache2 -k start
             ??13892 /usr/sbin/apache2 -k start
             ??13893 /usr/sbin/apache2 -k start

Dec 30 02:49:21 ubuntu2204 systemd[1]: Starting O Servidor HTTP Apache...

Uma vez que você tenha terminado, pode prosseguir para acessar a interface web do Zammad.

Acessar o Sistema de Chamadas Zammad

Neste ponto, o Zammad está instalado e configurado em seu servidor. Você pode agora acessá-lo usando a URL http://seu-ip-do-servidor. Você deve ver a seguinte página.

Clique em Configurar um novo sistema. Você deve ver a página de configuração da conta de administrador.

Forneça seu nome, e-mail, senha e clique no botão Criar. Você deve ver a seguinte página.

Defina o nome da sua empresa, URL do site e clique no botão Próximo. Você deve ver a página de Notificação por E-mail.

Selecione seu provedor de e-mail e clique no botão Continuar. Você deve ver a página do canal de comunicação.

Clique no botão Pular. Você deve ver o painel do Zammad na página seguinte.

Conclusão

Parabéns! você instalou e configurou com sucesso o sistema de chamadas Zammad no servidor Ubuntu 22.04. Agora você pode implementar o Zammad em sua organização e conectá-lo a canais de terceiros, como Facebook e telefone. Sinta-se à vontade para me perguntar se você tiver alguma dúvida.

Share: X/Twitter LinkedIn

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.