Principal Dicas & Tutoriais Entenda os volumes na stack do seu Chatwoot

Entenda os volumes na stack do seu Chatwoot

Última atualização em Aug 28, 2025

Muitas pessoas hospedam aplicações self-hosted seguindo tutoriais da internet mas em alguns casos esses videos (ou posts de blog) não explicam o que cada configuração da stack que você está fazendo deploy faz. Você coloca a aplicação em produção, funciona, recebe clientes e começa a faturar. Perfeito!

O problema começa a aparecer quando você precisa atualizar a versão do seu aplicativo e no tutorial diz pra você apagar os volumes X e Y. Ué? Mas no primeiro tutorial o professor não disse pra criar os volumes? Agora tenho que apagar? Será que eu perco tudo? Enfim.. todo mundo já passou por isso, eu quebrei a cabeça várias vezes e optei em alguns momentos por nem atualizar o aplicativo pra não correr o risco. Com o Chatwoot não foi diferente.

Deixa eu te explicar pra que serve os volumes na sua stack do Chatwoot:

O que são volumes?

Os volumes, de forma resumida, são pastas onde ficam armazenados arquivos. E no seu Chatwoot quais são os arquivos? Vou te explicar e mostrar a diferença de quais dados ficam no banco de dados e quais ficam nos volumes.

Quais arquivos ficam nos volumes?

Entre eles estão:

  • Fotos de conversas

  • Áudios enviados por contatos

  • Fotos de perfil dos agentes das accounts

  • Seu logotipo personalizado

E outros.. o importante é entender que ficam os arquivos binários. Áudios, imagens, PDFs, tudo que for arquivo que você enviou ou recebeu no Chatwoot.

E o que fica no banco de dados?

Eu não vou aprofundar em como funciona um banco de dados nesse artigo mas entenda que se os arquivos binários ficam nos volumes, no banco de dados ficam os dados. Não me entenda errado, não é que imagens, áudios e etc não sejam dados, eles são, mas em TIPOS diferentes.

No seu banco de dados fica o texto da última mensagem não lida, a ID da sua conta, o nome do contato, quando ele foi criado e etc..

Isso não fica nos volumes do Chatwoot (se você não estiver rodando o banco de dados na mesma stack e usando um nome tipo “chatwoot_db”, por exemplo). Fica no Postgres, dentro de outro serviço que tem outro volume e que funciona de forma parecida com essa que expliquei do Chatwoot.

Se eu apagar os volumes eu perco tudo então?

De forma resumida, sim! Mais especificamente se apagar o volume “chatwoot_data” (ou “chatwoot_storage”, dependendo da stack). Você só não vai perder se usar o S3 ao invés dos volumes e se estiver usando ele, não precisa do volume local.

Então, quando for atualizar ou limpar arquivos antigos do seu Chatwoot, você já sabe onde encontrar eles.

no próximo artigo eu te explico melhor sobre como funciona a integração com o S3. Te espero lá!