Backup do banco no Coolify: agendar e restaurar

Resposta rápida

Para fazer backup do banco no Coolify, abra o banco, entre em Backups e clique em + Add. Informe a frequência em formato cron, como 0 3 * * *, e clique em Add Schedule. O horário segue o fuso UTC: 0 3 * * * roda à meia-noite em Brasília. Na página do agendamento, defina quantos backups guardar, ligue a cópia para um armazenamento compatível com S3 e teste com Back Up Now. Para restaurar, use Import Backup, sabendo que a restauração muda os dados do banco.

O painel do Coolify é em inglês. Neste manual, os botões aparecem como estão na tela, em negrito, com a tradução ao lado. Dúvida com algum termo? Veja o glossário do Coolify em português.

Você vai aprender

Agendar o backup do banco com uma expressão cron
Acertar o horário, sabendo que o agendamento usa UTC
Limitar quantos backups ficam guardados na VPS
Mandar uma cópia para um armazenamento compatível com S3, fora da VPS
Restaurar um backup com segurança

Antes de começar

Um banco criado e rodando no Coolify (banco de dados no Coolify)
Para a cópia externa: um bucket já criado num serviço de armazenamento compatível com S3, com chave de acesso

Neste guia

Como o backup do banco funciona
Agende o backup
Guarde uma cópia fora da VPS
Restaure um backup
Problemas comuns

Como o backup do banco funciona

Agendamentouma expressão cron, no fuso do servidor (UTC por padrão)
Cópia do bancoo Coolify exporta o banco num arquivo, como o pg-dump do PostgreSQL
Cópia localem /data/coolify/backups, no disco da própria VPS
Cópia externanum armazenamento compatível com S3, fora da VPS

Do agendamento à cópia fora da VPS

O backup agendado existe para PostgreSQL, MySQL, MariaDB, MongoDB e ClickHouse. Redis, Dragonfly e KeyDB não têm backup agendado pelo painel: use a persistência e as ferramentas do próprio banco.

Agende o backup

Abra Backups e clique em + Add
No painel: ProjectsLoja Virtualproductionbanco-da-lojaBackups(Projetos › o seu projeto › o ambiente › o seu banco › Backups)
Na página do banco, abra Backups. Clique em + Add (adicionar) para criar um agendamento.
1. Botão + Add, que agenda um backup novo.
2. Botão Import Backup (importar backup), que restaura um arquivo de backup.
Informe a frequência e clique em Add Schedule
Em Frequency (frequência), use cron de 5 campos ou atalhos como daily. O exemplo 0 3 * * * roda todo dia às 3h UTC.
1. Frequência (Frequency), aqui 0 3 * * *.
2. Botão Add Schedule (adicionar agendamento).
Confira o agendamento
O painel abre a página do agendamento. Se não abrir sozinho, volte a Backups e clique em Manage backup schedule.
1. Frequency, com o fuso ao lado em Timezone (aqui, UTC).
2. Botão Open S3 Storage, para cadastrar o armazenamento externo.
3. Backups to keep, em Local backups: quantos backups ficam na VPS. 0 é sem limite.
4. Botão Back Up Now (fazer backup agora), que roda um backup na hora. O banco precisa estar rodando.
Rode um backup e veja o resultado
Clique em Back Up Now. Em Executions (execuções), o backup aparece como Success (sucesso), com data, tamanho e a cópia Local.
Dica Ligue o aviso de backup com falha nas notificações: veja equipe e notificações.

Exemplos de frequência (o agendamento usa UTC; Brasília fica 3 horas atrás)
Frequency	Quando roda (UTC)	Em Brasília
`0 3 * * *`	todo dia às 3h	meia-noite
`0 6 * * *`	todo dia às 6h	3h da manhã
`daily`	todo dia à 0h	21h do dia anterior
`0 6 * * 0`	domingo às 6h	domingo às 3h

Retenção: quantos backups guardar
Campo	O que preencher
Backups to keep	Quantidade de backups guardados. Recomendado: defina um número, como `7`.0 é sem limite: o disco da VPS enche com o tempo.
Days to keep	Apaga os backups mais velhos que esse número de dias.
Maximum storage (GB)	Espaço máximo que os backups podem ocupar.

A seção Retention (retenção) tem esses campos duas vezes: em Local backups, para a VPS, e em S3 backups, para a cópia externa.

Guarde uma cópia fora da VPS

O backup local fica em /data/coolify/backups, no mesmo disco do banco. Se a VPS tiver um problema, banco e backup somem juntos. Por isso, mande uma cópia para um armazenamento compatível com S3, de qualquer provedor que ofereça esse padrão.

Cadastre o armazenamento
No painel: IntegrationsStorageNew Storage(Integrações › Armazenamento › novo armazenamento)
Em New Storage, deixe Type (tipo) em S3, dê um nome e preencha os dados do serviço. Clique em Validate Connection & Continue (validar conexão e continuar).
1. Host: O endereço do serviço de armazenamento (aqui, s3.example.com).
2. Bucket: O bucket que vai receber os arquivos. Ele precisa existir antes.
3. Access Key: A chave de acesso que o serviço gerou.
4. Secret Key: O segredo da chave. Fica escondido no painel.
Ligue a cópia no agendamento
Volte à página do agendamento. Na seção S3 storage, clique em Enable S3 (ligar S3) e escolha o armazenamento validado em S3 storages.

Restaure um backup

Abra Import Backup
Em Backups, clique em Import Backup. Escolha o arquivo em Backup source (origem), por upload ou pelo caminho no servidor, e confira as opções antes de continuar.

Restaurar sobrescreve dados

O painel avisa: Restoring a backup changes database data (restaurar muda os dados do banco). A importação pode sobrescrever dados e credenciais. Antes de restaurar, rode um Back Up Now, para ter como voltar. Redis, Dragonfly e KeyDB não têm importação pelo painel.

Como saber se deu certo

O agendamento aparece em Backups, a execução mostra Success e, com o armazenamento ligado, cada backup vai também para fora da VPS.

Problemas comuns

O backup rodou num horário diferente do esperado

Causa provável: O agendamento usa o fuso do servidor, que é UTC por padrão. Brasília fica 3 horas atrás.
O que fazer: Some 3 horas ao horário de Brasília para escrever o cron. Para 3h da manhã em Brasília, use 0 6 * * *.

O disco da VPS está enchendo

Causa provável: Backups to keep e os outros campos de retenção ficaram em 0, que é sem limite.
O que fazer: Defina a retenção local, por exemplo Backups to keep em 7, e mande as cópias antigas para o armazenamento externo.

Validate Connection & Continue falha

Causa provável: Endereço do serviço errado, bucket que não existe ou chave sem permissão de listar e gravar.
O que fazer: Crie o bucket antes, confira o Host, a Region e a chave no painel do serviço de armazenamento e valide de novo.

A restauração falha com objetos que já existem

Causa provável: O banco já tem tabelas com os mesmos nomes do backup.
O que fazer: Marque Replace objects that already exist (substituir o que já existe), sabendo que isso sobrescreve dados. Faça um Back Up Now antes.

Não resolveu? Veja os problemas comuns do Coolify ou abra um chamado na central do cliente.

Próximo passoComo instalar serviços prontos no CoolifyO catálogo de serviços do Coolify na prática: buscar o modelo, publicar, abrir no navegador, ligar o domínio e atualizar com segurança.

Fontes e documentação oficial

Coolify é um software de código aberto mantido pelo próprio projeto. Este manual é da Hospedagem Segura, para quem roda o Coolify nas nossas VPS, e foi conferido na versão 4.7.5.

Continue aprendendo

Ver todos os guias do Manual do Coolify

Rode o Coolify numa VPS da Hospedagem Segura

VPS Linux com acesso root, disco NVMe e IPv4 dedicado a partir de R$ 69,90/mês. Prefere a VPS pronta? No VPS Assistido, o Coolify vem instalado, com o painel no seu domínio, e a equipe ajuda no dia a dia.

Ver VPS para Coolify Conhecer o VPS Assistido