Como instalar o Chatwoot do zero: o que mudou em 2026

Para instalar o Chatwoot do zero no seu próprio servidor, você precisa de uma VPS e um domínio: com o autoinstalador você sobe o Docker Swarm e o Portainer, cola a stack do Chatwoot, roda a migração do banco no container app e cria a conta de super admin.

A boa notícia é que o processo ficou mais curto. A stack agora já sobe com banco de dados e Redis, cria o banco sozinha e define o fuso horário. O que mudou de verdade foi a forma de personalizar: a pasta pública mapeada, que muita gente usava para trocar a logomarca, saiu de cena.

Neste guia eu explico o que você precisa ter antes de começar, o passo a passo da instalação com Portainer, como gerar uma imagem com a sua marca e quais novidades das últimas versões fazem diferença no dia a dia do atendimento. O vídeo completo, gravado em junho de 2026, está aqui:

O que você precisa antes de instalar

São só dois requisitos:

• uma VPS, que é uma máquina na nuvem onde o Chatwoot vai rodar;
• um domínio, que pode ser comprado no Registro.br ou no próprio provedor da VPS.

No vídeo eu uso a Hetzner, mas ela ficou cara depois do reajuste. A Hostinger tem bom custo-benefício. Escolha pelo seu bolso.

Preste atenção no sistema operacional. A recomendação continua sendo o Ubuntu 22, que é a versão que testamos e que roda bem. O 24 funciona. O 26 eu ainda não recomendo.

Para acessar o servidor eu uso o Bitvise, um programa de SSH que também mostra as pastas do servidor.

Apontando os subdomínios

Você vai precisar de dois endereços apontados para o IP da VPS: um para o Portainer e outro para o Chatwoot. Podem ser subdomínios do mesmo domínio ou domínios diferentes, tanto faz.

No Cloudflare, crie os dois registros apontando para o IP e desligue o proxy (a nuvem laranja). Com o proxy ligado, a geração do certificado pode dar erro.

Passo a passo: como instalar o Chatwoot com Portainer

Todos os arquivos e comandos que eu uso estão na página de apoio do vídeo, então não precisa copiar nada da tela.

1. Na VPS, pegue ou redefina a senha root no painel do provedor.
2. Conecte pelo Bitvise com o IP, porta 22, usuário root e a senha.
3. Arraste a pasta do autoinstalador (que está na página de apoio) para dentro do servidor.
4. No terminal, rode os dois comandos do tutorial que vem na pasta: um entra na pasta e o outro abre o instalador.
5. Informe um e-mail válido (ele é usado para o certificado SSL) e o domínio do Portainer.
6. Confirme digitando S. O instalador coloca o Docker e o Swarm no servidor e sobe o Portainer.
7. Abra o endereço do Portainer e crie o usuário administrador. A senha precisa ter pelo menos 12 caracteres.
8. Em Stacks, clique em adicionar, cole a stack do Chatwoot e troque o domínio em todos os pontos indicados no arquivo.
9. Se tiver um SMTP, preencha agora. Ele envia os e-mails de redefinição de senha e de convite de usuário. Não é obrigatório.
10. Desative o controle de acesso da stack, para conseguir editar depois sem dor de cabeça, e clique em deploy.
11. Quando os serviços subirem, vá em Containers, abra o container app (não o sidekiq), entre no console e rode o comando de migração que está na stack. Ele cria todas as tabelas do banco.
12. Abra o endereço do Chatwoot no navegador e crie a conta inicial, que vira o super admin.

O que mudou na stack de instalação

Quem já instalou com os tutoriais antigos do canal vai notar algumas diferenças:

• O Chatwoot agora tem o próprio Redis e o próprio Postgres dentro da stack. Você não precisa instalar um e outro separado.
• O Postgres sobe na versão 16 com a extensão pgvector, que o Chatwoot passou a exigir. Quem está na 14 ainda roda, mas para instalação nova vá direto na 16.
• O banco é criado e o fuso horário é definido pela própria stack. Antes era um passo manual depois do deploy.
• A stack já prevê storage externo e integração com o Google.
• A pasta pública não é mais mapeada como volume.

Mapear a pasta pública era um atalho para trocar a logomarca, mas nas versões recentes começou a dar conflito. E quem escala o Chatwoot com réplicas precisa que todo container tenha os mesmos arquivos. Por isso a personalização agora vai para dentro da imagem.

Como colocar a sua marca no Chatwoot (white label pela imagem)

Se você quer usar o Chatwoot do jeito que ele vem, pode pular esta parte. Se quer a sua logomarca e os e-mails em português, o caminho é gerar uma imagem personalizada.

Na página de apoio há uma pasta com um Dockerfile que parte da imagem oficial e só copia por cima os arquivos que você trocou. O build leva segundos, contra cerca de meia hora para compilar o repositório inteiro.

O que vai dentro da pasta:

• favicons: gere no site Favicon Generator a partir do ícone da sua marca, baixe o pacote e substitua os arquivos da pasta;
• brand-assets: a logo da tela de login e o ícone interno, obrigatoriamente em SVG e com o mesmo nome dos arquivos originais;
• e-mails: os modelos de notificação, que você pode traduzir.

Nos e-mails, traduza só o texto que o cliente lê, sem mexer nas variáveis.

Envie a pasta para o servidor pelo Bitvise, entre nela pelo terminal e rode o comando de build do tutorial. Atenção: o comando termina com um ponto, separado por um espaço. Nome e versão da imagem você pode mudar, e é bom mudar a versão a cada atualização.

Por fim, no Portainer, edite a stack do Chatwoot e troque a imagem oficial pela sua em todos os serviços que usam essa imagem (no vídeo eu mostro as linhas exatas). Clique em update. O Chatwoot fica fora do ar por alguns minutos e volta com a sua marca.

Na versão aberta, essa troca cobre o favicon, a tela de login e os e-mails. O painel de custom branding no super admin, que deixa a personalização mais completa, só aparece nas edições pagas.

Novidades do Chatwoot que valem a pena conhecer

No vídeo eu resumo as versões 4.10 a 4.13. Parte chegou para todos, parte é da edição Enterprise.

Na versão gratuita:

• Fluxos de conversa com resolução automática. Você define que, depois de um tempo sem atendimento, a conversa seja resolvida, receba uma mensagem (algo como "estamos com volume alto, aguarde") e ganhe uma etiqueta. Dá para pular conversas que já estão esperando resposta de um agente. O tempo mínimo é de 10 minutos.
• Filtros novos: mencionadas, participando e não atendidas.
• Automações renovadas, com a ação de atribuir ao último agente que respondeu. Antes isso exigia gambiarra ou um fluxo no n8n.

Na edição Enterprise:

• SSO em Segurança, para entrar no Chatwoot a partir de outro sistema.
• Políticas de atribuição: rodízio ou distribuição equilibrada pela capacidade, com prioridade para a conversa mais antiga ou para quem espera há mais tempo. Há um limite justo por agente, que por padrão é de 100 conversas por hora.
• Capacidade do agente, com opção de não contar conversas de certas etiquetas, como a carteira antiga de um vendedor.
• Captain, o agente de IA nativo, agora aceita PDF nos documentos e tem ferramentas que chamam APIs externas, como buscar a segunda via de um boleto.

A lista completa está nas releases do repositório oficial do Chatwoot no GitHub.

Erros comuns na instalação

• Deixar o proxy do Cloudflare ligado nos subdomínios.
• Usar uma versão de Ubuntu ainda não testada.
• Rodar a migração no container sidekiq em vez do app.
• Esquecer o ponto no final do comando de build.
• Salvar o SVG com outro nome.
• Trocar a imagem em só um dos serviços da stack e esquecer os outros.

O lado honesto da instalação própria

Mesmo com o autoinstalador, você vai mexer em terminal, DNS e stack. E o servidor passa a ser responsabilidade sua: atualizar, acompanhar o disco e manter cópias do banco. Se ainda não tem uma rotina para isso, veja como montar um backup automático do Chatwoot com n8n.

Também explico em outro artigo por que eu instalo tudo pelo Portainer em vez de painéis de um clique: a comparação está em Portainer, EasyPanel ou Coolify. E se você ainda está conhecendo a ferramenta, comece pelo guia do que é o Chatwoot.

Perguntas frequentes

Como instalar o Chatwoot?

Aponte dois subdomínios para a VPS (um para o Portainer e outro para o Chatwoot), rode o autoinstalador que coloca Docker, Swarm e Portainer e crie no Portainer a stack do Chatwoot com o seu domínio. Depois rode o comando de migração no container app e crie a conta inicial, que vira o super admin.

O que preciso para instalar o Chatwoot?

Uma VPS e um domínio. Para o sistema operacional, a recomendação é o Ubuntu 22, que é a versão testada. O 24 funciona e o 26 ainda não é recomendado.

Qual versão do Postgres usar no Chatwoot?

Para instalação nova, o Postgres 16 com a extensão pgvector, que o Chatwoot passou a exigir. Quem está na versão 14 ainda roda, e a stack atual já sobe o Postgres e o Redis junto com o Chatwoot.

Como colocar a minha logomarca no Chatwoot?

Gere uma imagem Docker própria a partir da imagem oficial, com os favicons, a logo em SVG com o mesmo nome dos arquivos originais e os e-mails traduzidos, e troque a imagem em todos os serviços da stack. Na versão aberta, isso cobre o favicon, a tela de login e os e-mails.

Por que o certificado SSL do Chatwoot dá erro na instalação?

O motivo mais comum é o proxy do Cloudflare ligado nos subdomínios. Desligue a nuvem laranja nos registros que apontam para a VPS, porque com o proxy ativo a geração do certificado pode falhar.

Quer pular a instalação e já começar com mais recursos?

O AstraChat é o Chatwoot Pro que mantemos na Astra Online. Roda no seu servidor, com a sua marca, atendentes ilimitados e recursos que a versão aberta não tem: Kanban, agentes de IA, disparador, ligações pelo WhatsApp, flows e chat interno.

Ele vem na Comunidade Astra Online, com código-fonte, atualizações, grupo VIP e a primeira instalação feita pelo especialista em Chatwoot Raphael Popiolek. Me chame no WhatsApp e me conte quantos números e atendentes você tem hoje, que eu digo qual servidor contratar.