Ir para o conteúdo
Documentação
DocumentaçãoBackup e recuperação

Backup e recuperação

Banco e chaves precisam permanecer juntos. A mesma regra vale para os certificados no servidor.

O que é preservado

Dados e credenciais

PostgreSQL, Redis, arquivos de senha e chaves usadas para cifrar credenciais das integrações.

Configuração e HTTPS

Compose, ambiente, Caddyfile, certificados e estado do Caddy.

O atualizador faz um backup físico com os serviços parados. Os arquivos ficam na pasta backups, com permissões restritas. O marcador COMPLETE indica que todos os arquivos previstos foram gerados.

Se uma atualização falhar

  • Durante o download: os containers existentes continuam como estavam.
  • Durante o backup: os containers antigos são retomados; o backup parcial permanece sem marcador de conclusão.
  • Após iniciar a API nova: migrations podem ter alterado o banco. API e frontend são parados para evitar um rollback automático incorreto.
Terminal
docker compose ps
docker compose logs --tail=100 api web
Trocar a tag da imagem não desfaz migrations. Uma recuperação pode exigir restaurar todos os volumes de um mesmo backup usando as versões compatíveis de PostgreSQL e Redis.

Cuidados com os backups

  • Guarde uma cópia externa protegida e teste a restauração.
  • Não publique backups em repositórios: eles contêm dados e segredos.
  • Não misture o banco de um backup com as chaves de outro.
  • Não use docker compose down -v nem remova os volumes da instalação.
Baixar guia completo de recuperação