Base de Conhecimento

Chatwoot na VPS: central de atendimento própria

  • chatwoot, docker, central de atendimento, vps, nginx
  • Usuários acharam útil: 0

Veja como instalar o Chatwoot numa VPS com Docker Compose: requisitos, arquivos .env e Compose, HTTPS com Nginx, primeiro acesso de super admin e como atualizar.

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

Arte da Eleven Host: janela de terminal com o título: Chatwoot na VPS: central de atendimento própria

Capa da Redação Eleven Host para o tutorial: Chatwoot na VPS: central de atendimento própria Arte: Eleven Host

Chatwoot na VPS é uma forma de ter a sua própria central de atendimento, com as conversas dos clientes num servidor que você controla. O Chatwoot é uma plataforma de suporte de código aberto, e a instalação com Docker leva alguns arquivos e comandos.

Neste guia você vê o que é o Chatwoot, o que a licença diz, o que a documentação pede de requisitos e como subir o sistema com Docker Compose. Depois, como colocá-lo atrás de um proxy com HTTPS, criar o primeiro acesso e atualizar a instalação. Se você ainda não conhece o servidor VPS, comece por O que é servidor VPS: guia simples para iniciantes. Os exemplos usam chat.exemplo.com como endereço fictício.

O que é o Chatwoot e quais canais ele atende

O README do projeto no GitHub o descreve como a plataforma moderna de suporte ao cliente, uma alternativa de código aberto a ferramentas como Intercom e Zendesk, que você hospeda por conta própria (self-hosted).

Entre os canais citados no README estão chat ao vivo no site, e-mail, Facebook, Instagram, Twitter, Telegram, Line e SMS, além de apps de mensagem. Há também integrações com Slack, Dialogflow, Shopify, Google Translate e Linear, o Captain (um agente de IA) e uma central de ajuda (Help Center).

A lista de canais mostra o que o projeto suporta. Este guia cobre só a instalação do Chatwoot em si.

Licença: o que o README e o arquivo LICENSE dizem

O README afirma que o Chatwoot é distribuído sob a licença MIT. O arquivo LICENSE do repositório detalha melhor: o conteúdo da pasta enterprise/, quando ela existe, tem a licença própria definida em enterprise/LICENSE. O restante está sob a licença "MIT Expat". Componentes de terceiros continuam com a licença original.

Na prática, isso significa que o núcleo do Chatwoot é MIT, mas partes da pasta enterprise têm licença própria.

Para usar só a parte comunitária, a documentação oferece a tag de imagem latest-ce. Em caso de dúvida sobre uso comercial, consulte um profissional.

Requisitos segundo a documentação

A documentação de instalação própria (self-hosted) traz uma tabela de requisitos. O mínimo é de 2 cores de CPU, 4GB de RAM, 20GB de SSD e Ubuntu 20.04 ou uma distribuição Linux compatível. Para produção, a recomendação é 4 ou mais cores, 8GB ou mais de RAM e 50GB ou mais de SSD.

O sistema usa PostgreSQL 12 ou superior e Redis 6 ou superior, além de um proxy reverso, Nginx ou similar. Na instalação com Docker, esses dois bancos sobem em contêineres pelo próprio arquivo do Compose. A página do Docker pede, no mínimo, Docker 20.10.10 e Docker Compose v2.14.1.

As opções de instalação são script em máquina Linux, Docker, Kubernetes (Helm) e instalação com um clique em provedores de nuvem. Este guia segue o caminho do Docker. Os comandos usam o apt, e a documentação pede Ubuntu ou uma distribuição Linux compatível.

Está comparando planos de servidor? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS

Instalar o Docker e baixar os arquivos

Os comandos abaixo vêm da página de instalação com Docker da documentação do Chatwoot. O apt-get upgrade e o apt install pedem confirmação antes de continuar.

apt-get update

apt-get upgrade

curl -fsSL https://get.docker.com -o get-docker.sh

sudo sh get-docker.sh

apt install docker-compose-plugin

O script get-docker.sh é de terceiros e roda no seu servidor. Ele é baixado para um arquivo, e não executado direto da internet, o que dá a chance de abrir e ler o conteúdo antes do sudo sh.

Em seguida, baixe o .env de exemplo e o docker-compose.yaml de produção, ambos do repositório oficial:

wget -O .env https://raw.githubusercontent.com/chatwoot/chatwoot/develop/.env.example

wget -O docker-compose.yaml https://raw.githubusercontent.com/chatwoot/chatwoot/develop/docker-compose.production.yaml

Os arquivos vêm do branch develop, e a imagem do Compose é chatwoot/chatwoot:latest. Para fixar uma versão, troque o latest por uma tag de versão, depois de conferir o nome exato dela no Docker Hub. Na página de versões do GitHub, a v4.19.1 aparece como a release de 24 de outubro.

Configurar o .env e o docker-compose.yaml

A documentação manda editar o .env e o docker-compose.yaml com o nano. Estas são as linhas que pedem atenção no .env:

SECRET_KEY_BASE=replace_with_lengthy_secure_hex

FRONTEND_URL=http://0.0.0.0:3000

ENABLE_ACCOUNT_SIGNUP=false

REDIS_PASSWORD=

POSTGRES_PASSWORD=

  • SECRET_KEY_BASE: o arquivo diz que ele verifica a integridade dos cookies assinados, que deve ser alfanumérico, sem caracteres especiais, e que pode ser gerado com rake secret. Como alternativa, o comando openssl rand -hex 64 gera um valor hexadecimal.
  • FRONTEND_URL: o comentário do arquivo manda trocar pela URL que você vai usar. Aqui, https://chat.exemplo.com.
  • ENABLE_ACCOUNT_SIGNUP: com false, os endpoints de cadastro ficam desligados. É o valor que já vem no exemplo.
  • REDIS_PASSWORD: com Docker Compose, pode ser um texto à sua escolha, e ele passa a ser a senha do Redis do Compose.
  • POSTGRES_PASSWORD: vem vazia. O Compose traz o aviso "Please provide your own password", e a senha tem de ser a mesma no .env e no docker-compose.yaml.

O exemplo vem com RAILS_ENV=development, mas o Compose de produção define RAILS_ENV=production nos serviços. Os dados de e-mail também têm de ser ajustados: SMTP_PORT=1025 é o valor do exemplo, e SMTP_ADDRESS vem vazio. Segundo o arquivo, com o endereço vazio o Chatwoot tenta usar o sendmail (postfix). Para enviar e-mails de verdade, use um serviço de SMTP e preencha SMTP_ADDRESS, SMTP_PORT, SMTP_USERNAME e SMTP_PASSWORD com os dados dele.

No Compose, a porta 3000 do Rails fica publicada só em 127.0.0.1, assim como o Postgres (5432) e o Redis (6379). Para acessar o Chatwoot de fora, a documentação usa um proxy, que é o próximo passo.

Subir o Chatwoot

Com os dois arquivos prontos, prepare o banco de dados e suba os serviços:

docker compose run --rm rails bundle exec rails db:chatwoot_prepare

docker compose up -d

Para conferir se o Rails respondeu, rode o comando abaixo. A documentação diz que o retorno esperado é o código 200.

curl -I localhost:3000/api

Se o retorno for outro, veja os registros dos contêineres e confirme que as senhas do Postgres batem nos dois arquivos. Para checar quais portas estão escutando no servidor, o guia Portas abertas no Linux: como ver com ss e lsof na VPS mostra os comandos.

Colocar o HTTPS na frente com Nginx

A documentação usa o Nginx como proxy reverso e o Certbot para o certificado. Os comandos são estes:

sudo apt-get install nginx

cd /etc/nginx/sites-enabled

nano chat.exemplo.com.conf

No arquivo do site, troque o yourdomain.com do exemplo oficial pelo seu domínio no server_name. O exemplo da documentação usa estas diretivas, entre outras:

underscores_in_headers on;

set $upstream 127.0.0.1:3000;

proxy_pass http://$upstream;

client_max_body_size 0;

proxy_read_timeout 36000s;

Copie o arquivo completo da página oficial, porque as diretivas acima são só parte dele. Depois valide a sintaxe, recarregue o Nginx e emita o certificado:

nginx -t

systemctl reload nginx

apt install certbot

apt-get install python3-certbot-nginx

mkdir -p /var/www/ssl-proof/chatwoot/.well-known

certbot --webroot -w /var/www/ssl-proof/chatwoot/ -d chat.exemplo.com -i nginx

O domínio precisa apontar para o IP do servidor antes de pedir o certificado. Se você já usa outro proxy na VPS, o guia Nginx Proxy Manager: vários sites numa VPS só mostra uma alternativa com painel. Ele não é o caminho da documentação do Chatwoot, então ajuste o encaminhamento para a porta 3000 local.

Primeiro acesso e super admin

A documentação diz que o primeiro usuário criado durante o onboarding é um super admin, e que o console de administração fica em /super_admin, depois do endereço da instalação. Não existe usuário e senha padrão.

Por isso, crie a sua conta logo depois de subir o sistema, antes de divulgar o endereço. Para outros super admins, entre no console, abra a seção de usuários e crie um novo com o tipo super admin.

Com ENABLE_ACCOUNT_SIGNUP=false, os endpoints de cadastro ficam desligados.

Atualizar o Chatwoot

A documentação traz esta sequência para atualizar:

docker compose pull

docker compose up -d

docker compose run --rm rails bundle exec rails db:chatwoot_prepare

Se você não usa as tags latest ou latest-ce, troque a tag no Compose antes. Instalações muito antigas devem subir por versões intermediárias, lendo as notas de versão e rodando o db:chatwoot_prepare a cada passo. Para o console do Rails, a documentação traz um comando com docker exec no contêiner rails e RAILS_ENV=production.

Backup e cuidados com os dados

A página de instalação com Docker não traz uma seção de backup. Por isso, recomendamos guardar uma cópia do volume do Postgres (postgres_data), do storage_data, onde ficam os anexos quando ACTIVE_STORAGE_SERVICE=local, e do arquivo .env, em outro lugar fora do servidor. Sem o .env, você perde as senhas e a chave do sistema.

Checklist do Chatwoot na VPS

  • Docker 20.10.10 e Docker Compose v2.14.1 ou superiores.
  • Senha do Postgres igual no .env e no docker-compose.yaml; senha do Redis definida.
  • SECRET_KEY_BASE trocado e FRONTEND_URL com o endereço real.
  • SMTP de um serviço de e-mail configurado no .env.
  • db:chatwoot_prepare executado antes do docker compose up -d.
  • curl -I localhost:3000/api com retorno 200.
  • Nginx com HTTPS na frente da porta 3000 local.
  • Conta de super admin criada antes de divulgar o endereço.
  • Cópia do Postgres, do storage e do .env fora do servidor.

Já escolheu o servidor para o seu projeto? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS

Perguntas frequentes

O que é o Chatwoot?

É uma plataforma de suporte ao cliente de código aberto, que você pode hospedar por conta própria. Segundo o README, é uma alternativa a ferramentas como Intercom e Zendesk.

Qual é a licença do Chatwoot?

O README cita a licença MIT, mas a pasta enterprise/ tem licença própria. Para a parte comunitária, a documentação oferece a tag latest-ce. Em caso de dúvida sobre uso comercial, consulte um profissional.

Qual é o login e a senha padrão do Chatwoot?

Não existe login padrão. O primeiro usuário criado no onboarding vira super admin, por isso crie a sua conta logo após subir o sistema.

Em qual porta o Chatwoot roda?

O Rails roda na porta 3000, publicada só em 127.0.0.1 pelo Compose. Para acessar de fora, a documentação usa um proxy reverso com Nginx e HTTPS.

Como atualizar o Chatwoot?

Rode docker compose pull, depois docker compose up -d e, por fim, docker compose run --rm rails bundle exec rails db:chatwoot_prepare.

Esta resposta lhe foi útil?

Artigos Relacionados