wils@web ~ $ cat ~/ajuda/como-instalar-e-configurar-o-chatwoot-3-12-como-uma-aplicacao-self-hosted-utilizando-docker.md

Docker

Como instalar e configurar o Chatwoot 3.12 como uma aplicação self-hosted utilizando Docker

atualizado em 02/08/2026

O Chatwoot é uma plataforma de atendimento ao cliente de código aberto que pode ser instalada localmente utilizando Docker. Neste manual, vamos abordar como instalar e configurar o Chatwoot versão 3.12 como uma aplicação self-hosted.

Pré-requisitos

  • Docker e Docker Compose instalados
  • Um servidor Linux (Ubuntu, por exemplo)
  • Conhecimento básico de linha de comando

Passo a Passo

1. Instalar Docker e Docker Compose

sudo apt update
sudo apt install docker.io docker-compose

2. Baixar o repositório do Chatwoot

git clone https://github.com/chatwoot/chatwoot.git
cd chatwoot
git checkout v3.12

3. Configurar variáveis de ambiente

Copie o arquivo de exemplo de configuração:

cp .env.example .env

Edite o arquivo .env para configurar as variáveis necessárias, como:

DATABASE_URL=postgres://chatwoot:password@db/chatwoot
REDIS_URL=redis://redis:6379

4. Iniciar os serviços

Utilize o Docker Compose para subir os serviços:

docker-compose up -d

5. Executar as migrações do banco de dados

docker-compose run --rm web rake db:migrate

6. Acessar a aplicação

Após a instalação, acesse o Chatwoot através do seu navegador em:

http://localhost:3000

Conclusão

Agora você tem o Chatwoot 3.12 instalado e configurado em seu servidor. Para garantir a segurança da sua aplicação, considere configurar um proxy reverso com SSL utilizando Nginx.

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.