wils@web ~ $ cat ~/ajuda/guia-para-configurar-o-chatwoot-5-2-em-uma-arquitetura-de-microservicos-com-docker-compose.md

Docker

Guia para configurar o Chatwoot 5.2 em uma arquitetura de microserviços com Docker Compose

atualizado em 26/07/2026

O Chatwoot é uma plataforma de atendimento ao cliente de código aberto que pode ser configurada em uma arquitetura de microserviços utilizando Docker Compose. Este guia irá orientá-lo através do processo de instalação do Chatwoot 5.2.

Pré-requisitos

  • Docker e Docker Compose instalados
  • Git instalado

Passo a Passo para Configuração

1. Clonar o repositório do Chatwoot

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

2. Navegar até o diretório do Chatwoot

cd chatwoot

3. Criar um arquivo .env

Copie o arquivo de exemplo para criar um novo arquivo .env:

cp .env.example .env

4. Configurar variáveis de ambiente

Edite o arquivo .env e configure as variáveis de acordo com suas necessidades:

nano .env

5. Criar o arquivo docker-compose.yml

Crie um arquivo docker-compose.yml com o seguinte conteúdo:

version: '3'
services:
  chatwoot:
    image: chatwoot/chatwoot:5.2
    ports:
      - '3000:3000'
    environment:
      - DATABASE_URL=postgres://chatwoot:password@db/chatwoot
    depends_on:
      - db

  db:
    image: postgres:12
    environment:
      POSTGRES_USER: chatwoot
      POSTGRES_PASSWORD: password
      POSTGRES_DB: chatwoot
    volumes:
      - db_data:/var/lib/postgresql/data

volumes:
  db_data:

6. Iniciar os serviços

Com o arquivo docker-compose.yml criado, inicie os serviços:

docker-compose up -d

7. Executar migrações

Após iniciar os serviços, execute as migrações do banco de dados:

docker-compose exec chatwoot rake db:migrate

8. Acessar a aplicação

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

Conclusão

Você agora tem o Chatwoot 5.2 rodando em uma arquitetura de microserviços com Docker Compose. Para uma melhor performance, considere a utilização de um banco de dados externo e a configuração de um proxy reverso.

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.