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

Docker

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

atualizado em 03/08/2026

O Chatwoot é uma plataforma de atendimento ao cliente de código aberto que permite gerenciar interações com clientes de maneira eficaz. Neste manual, iremos instalar e configurar o Chatwoot 4.0 como uma aplicação self-hosted utilizando Docker.

Pré-requisitos

  • Docker e Docker Compose instalados
  • Um servidor Linux (Ubuntu 20.04 ou superior recomendado)
  • Domínio ou IP público para acesso

Passo a Passo para Instalação

1. Atualizar o Sistema

sudo apt update && sudo apt upgrade -y

2. Instalar Docker e Docker Compose

sudo apt install docker.io docker-compose -y

3. Baixar o Código do Chatwoot

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

4. Configurar Variáveis de Ambiente

Crie um arquivo `.env` com as variáveis necessárias:
cp .env.example .env
Edite o arquivo `.env` com suas configurações, como banco de dados e credenciais de e-mail:
nano .env

5. Iniciar o Docker Compose

Inicie os serviços do Chatwoot:
docker-compose up -d

6. Executar Migrations

Após iniciar os containers, execute as migrations:
docker-compose run --rm web rake db:migrate

7. Acessar o Chatwoot

Acesse o Chatwoot através do seu navegador utilizando o domínio ou IP configurado. O endereço padrão é http://localhost:3000.

Conclusão

O Chatwoot agora está instalado e funcionando em seu servidor. Para garantir a segurança, considere configurar um proxy reverso com Nginx e habilitar HTTPS.

Dica: Mantenha o Chatwoot atualizado para aproveitar novos recursos e correções de segurança.

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.