Backup

Um backup é uma cópia do banco de dados, das imagens e da versão do painel do seu site. Ele serve para voltar o site a um momento anterior. A tela Backup faz as três coisas: gera, baixa e restaura.

Backup automático

O painel faz o backup sozinho, uma vez por dia. A cada hora ele confere quando foi o último automático. Se ele tem um dia ou mais, um novo é criado. Ao subir, o painel também faz essa checagem. Assim, com o painel no ar, há um backup automático com até um dia de idade.

O cartão Rotina de backup mostra a regra: Automático todo dia, quantos automáticos ficam guardados e quando foi o último backup.

Os backups guardados

Os backups aparecem na tabela Backups, do mais novo para o mais antigo:

Coluna	O que mostra
Backup	O tipo e a data e a hora de criação, como `Manual — 24/10/2026, 14:00`.
Tipo	Automático, Manual ou Antes de restaurar.
Tamanho	O tamanho do arquivo, em KB ou MB.

Cada linha tem duas ações:

Baixar salva o arquivo .tar.gz no seu computador. O download fica registrado na atividade.

O arquivo baixado tem os dados dos usuários: os e-mails e os hashes das senhas. Guarde-o com o mesmo cuidado e não o envie por e-mail. Veja o que cada backup guarda, na página da linha de comando.

Restaurar abre o formulário de restauração com aquele backup já escolhido.

Os arquivos ficam em storage/backups/, no servidor. Cada nome tem a forma backup-<instante UTC>-<tipo>.tar.gz, em que <tipo> é auto, manual ou pre-restore, conforme a coluna Tipo.

Quando ainda não há nenhum, a tabela mostra Nenhum backup ainda e a orientação de usar Gerar backup agora.

Gerar um backup agora

Clique em Gerar backup agora. O backup criado é do tipo Manual, e a tela mostra Backup gerado. quando termina.

Os backups manuais não são apagados pelo painel. Apague-os no servidor quando não precisar mais deles.

Quanto tempo cada backup fica guardado

Tipo	Quantos ficam
Automático	Os 7 backups mais recentes. Ao criar um novo, o mais antigo é apagado.
Antes de restaurar	Os 3 backups mais recentes.
Manual	Até você apagá-lo no servidor.

Restaurar um backup

Restaurar troca o estado atual do site pelo estado do backup escolhido. Antes de começar, saiba o que acontece:

Um backup do estado atual é feito primeiro, com o tipo Antes de restaurar. Se essa cópia falhar, nada é alterado.
Todo mundo sai do painel. Você também precisa entrar de novo.
Os links de convite e de recuperação de senha enviados antes deixam de valer.
Quem foi excluído depois do backup volta a existir.
Um titular apagado pela Privacidade continua nos backups até eles expirarem.
O painel pede uma nova publicação do site, com o motivo Restauração de backup (veja Publicação). Pela linha de comando isso não acontece: a publicação precisa ser feita à mão, na tela Publicação.

Para restaurar:

Clique em Restaurar na linha do backup, ou escolha o backup no campo Backup do formulário Restaurar.
Marque Entendo que o estado atual do site será substituído.
Clique em Restaurar backup.

Quando a restauração termina, a tela de entrada mostra: Backup restaurado. Todos saíram do painel: entre de novo. Links de convite e de recuperação anteriores deixaram de valer, e quem foi excluído depois do backup voltou.

Quando o painel recusa a restauração

Nestes casos a restauração não começa, e nada é alterado:

Marque a confirmação para restaurar.: falta marcar a caixa de confirmação.
Escolha um backup da lista.: o backup escolhido não existe mais na lista.
O arquivo não é um backup legível (esperado um .tar.gz criado pelo painel).: o arquivo está corrompido ou não foi criado pelo painel.
Este backup é de uma versão mais nova do painel (<versão do backup>) do que a instalada (<versão instalada>). Atualize o painel antes de restaurar.: primeiro atualize o painel.
Este backup é de outra versão do painel (<versão do backup>; a instalada é <versão instalada>). Restaure pela linha de comando com o serviço parado: slash backup --restore.: a restauração de outra versão só é feita pela linha de comando, com o serviço parado. Veja como fazer o backup e a restauração pela linha de comando.

Se a restauração começa mas o banco de dados não volta, a mensagem diz Não foi possível restaurar o banco de dados (<motivo>). Nada foi alterado.. Se o backup volta, mas as sessões não podem ser encerradas, a mensagem diz O backup foi restaurado, mas as sessões não foram encerradas: <motivo>. Nesse caso, peça ajuda ao responsável pelo servidor antes de continuar.

Telas desta página

Para quem implanta ou estende: as rotas desta tela.

Método	Caminho	Dono	Título	Permissão	Sem sessão
GET	`/painel/backup`	core	Backup	`core.backup`	Não
POST	`/painel/backup/gerar`	core	Backup	`core.backup`	Não
POST	`/painel/backup/restaurar`	core	Backup	`core.backup`	Não
GET	`/painel/backup/baixar/:nome`	core	Backup	`core.backup`	Não