wils@web ~ $ cat ~/ajuda/como-instalar-e-configurar-o-chatwoot-3-16-em-um-container-docker.md

Docker

Como instalar e configurar o Chatwoot 3.16 em um container Docker

atualizado em 21/07/2026

O Chatwoot é uma plataforma de atendimento ao cliente de código aberto que pode ser facilmente instalada e configurada usando o Docker. Neste manual, você aprenderá como instalar e configurar o Chatwoot versão 3.16 em um container Docker.

Pré-requisitos

  • Docker instalado na sua máquina.
  • Docker Compose instalado.
  • Uma conexão com a internet.

Passo a passo para instalação

1. Criar um diretório para o Chatwoot

mkdir chatwoot
cd chatwoot

2. Criar o arquivo docker-compose.yml

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

version: '3'
services:
  postgres:
    image: postgres:12
    environment:
      POSTGRES_USER: chatwoot
      POSTGRES_PASSWORD: chatwoot
      POSTGRES_DB: chatwoot_production
    volumes:
      - postgres_data:/var/lib/postgresql/data

  redis:
    image: redis:alpine

  chatwoot:
    image: chatwoot/chatwoot:v3.16
    environment:
      DATABASE_URL: postgres://chatwoot:chatwoot@postgres/chatwoot_production
      REDIS_URL: redis://redis:6379
      SECRET_KEY_BASE: 
      FRONTEND_URL: http://localhost:3000
    ports:
      - '3000:3000'
    depends_on:
      - postgres
      - redis

volumes:
  postgres_data:

3. Substituir a chave secreta

Substitua <sua_chave_secreta> por uma chave secreta gerada. Você pode usar o comando:

openssl rand -hex 32

4. Iniciar os containers

docker-compose up -d

5. Executar as migrações

docker-compose exec chatwoot rake db:migrate

6. Criar um usuário administrador

docker-compose exec chatwoot rake chatwoot:admin:create

Conclusão

Após seguir os passos acima, o Chatwoot estará rodando em http://localhost:3000. Lembre-se de que você pode personalizar a configuração conforme necessário. Para produção, considere usar um proxy reverso como o Nginx e configurar HTTPS.

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.