Chatwoot na VPS: central de atendimento própria
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

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 comandoopenssl rand -hex 64gera 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
.enve nodocker-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
.enve nodocker-compose.yaml; senha do Redis definida. SECRET_KEY_BASEtrocado eFRONTEND_URLcom o endereço real.- SMTP de um serviço de e-mail configurado no
.env. db:chatwoot_prepareexecutado antes dodocker compose up -d.curl -I localhost:3000/apicom 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
.envfora 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.