wils@web ~ $ cat ~/ajuda/guia-pratico-para-configurar-o-chatwoot-4-0-como-um-sistema-de-suporte-ao-cliente-self-hosted.md

Docker

Guia prático para configurar o Chatwoot 4.0 como um sistema de suporte ao cliente self-hosted

atualizado em 21/08/2026

O Chatwoot é uma plataforma de suporte ao cliente de código aberto que permite que as empresas gerenciem suas interações com clientes de forma eficiente. Este guia prático irá orientá-lo na configuração do Chatwoot 4.0 em um ambiente self-hosted.

Pré-requisitos

  • Servidor Linux (Ubuntu 20.04 ou superior recomendado)
  • Docker e Docker Compose instalados
  • PostgreSQL instalado
  • Node.js (versão 14 ou superior)

Passo 1: Instalar Dependências

sudo apt update
sudo apt install -y git curl

Passo 2: Clonar o Repositório do Chatwoot

git clone https://github.com/chatwoot/chatwoot.git
cd chatwoot

Passo 3: Configurar o Ambiente

Crie um arquivo .env a partir do exemplo fornecido:

cp .env.example .env

Edite o arquivo .env e configure as variáveis necessárias, como DATABASE_URL e SECRET_KEY_BASE.

Passo 4: Configurar o Banco de Dados

docker-compose run --rm web bundle exec rails db:setup

Passo 5: Iniciar os Serviços

docker-compose up -d

Isso iniciará o Chatwoot em segundo plano.

Passo 6: Acessar a Interface Web

Abra o navegador e acesse http://localhost:3000 para visualizar a interface do Chatwoot.

Conclusão

Após seguir esses passos, você terá o Chatwoot 4.0 configurado e funcionando como um sistema de suporte ao cliente self-hosted. Dica: Sempre mantenha seu sistema atualizado e faça backups regulares do banco de dados.

Precisa de ajuda com isso no seu servidor? A gente resolve pra você.

falar no WhatsApp

// deu erro ou não funcionou?

Achou algo errado neste manual?

Conta pra gente o que deu errado ou qual erro apareceu — a gente corrige. Se quiser retorno, deixe seu contato.