wils@web ~ $ cat ~/ajuda/como-instalar-e-configurar-o-chatwoot-2-12-em-um-container-docker-no-ubuntu-22-04-guia-passo-a-passo.md

Docker

Como instalar e configurar o Chatwoot 2.12 em um container Docker no Ubuntu 22.04: Guia passo a passo

atualizado em 27/08/2026

O Chatwoot é uma plataforma de atendimento ao cliente de código aberto que permite gerenciar interações com clientes de forma eficiente. Este guia irá orientá-lo na instalação e configuração do Chatwoot 2.12 em um container Docker no Ubuntu 22.04.

Pré-requisitos

  • Ubuntu 22.04 instalado.
  • Docker e Docker Compose instalados.

Passo a Passo

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 repositório do Chatwoot

git clone https://github.com/chatwoot/chatwoot.git
cd chatwoot
git checkout v2.12.0

4. Configurar as variáveis de ambiente

Crie um arquivo .env com as variáveis necessárias:

cp .env.example .env

Edite o arquivo .env conforme necessário:

nano .env

5. Iniciar os containers

docker-compose up -d

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

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

7. Acessar o Chatwoot

Após a instalação, acesse o Chatwoot pelo navegador em:

http://localhost:3000

Conclusão

O Chatwoot agora deve estar instalado e funcionando em seu sistema. Para garantir um desempenho ideal, considere configurar backups regulares e monitorar o uso de recursos do Docker.

Dica: Para persistência de dados, configure volumes no Docker para o banco de dados e arquivos de mídia.

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.