A tela Backups gera cópias compactadas de cada conta de hospedagem: arquivos da home e, se você quiser, os bancos MySQL/MariaDB e PostgreSQL da conta. Você pode rodar na hora ou deixar agendado uma vez por dia.
Acesse pelo menu Hospedagem > Backups.
O que entra no backup
Cada backup é um arquivo .tar.gz por conta, com:
| Conteúdo | Observação |
|---|---|
Arquivos da home (/home/<usuario>) |
Fica na raiz do arquivo. |
| Bancos MySQL/MariaDB da conta | Opcional. Ficam em db/<banco>.sql.gz dentro do arquivo. |
| Bancos PostgreSQL da conta | Opcional. Ficam em db/<banco>.pgsql.gz dentro do arquivo. |
vendor e node_modules |
Só entram se você marcar Incluir vendor/node_modules. |
Os bancos considerados "da conta" são os que seguem a convenção de nome (usuario ou usuario_*) e os criados na tela Bancos de Dados com a conta como dona (inclusive os trazidos pela Migracao). Um banco com outro nome, criado fora do painel, não entra no backup automático.
Itens que nunca entram, por serem grandes, temporários ou fáceis de recriar:
.cache,tmpelogsna raiz da home;- caches de aplicação (
var/cache,var/page_cache,var/sessiondentro dos sites); .npme.composer/cache.
Os logs do servidor web e dos serviços da conta ficam fora da home, em /var/log/minicp/users/<usuario>/, e também não entram no backup.
Atenção: dados do Redis e configurações do servidor (vhosts, pools PHP, certificados) não fazem parte deste backup.
Onde os backups ficam
Os arquivos ficam no próprio servidor, em:
/var/lib/minicp/backups/<usuario>/<usuario>-AAAAMMDD-HHMMSS.tar.gz
A pasta e os arquivos ficam acessíveis só para o root (permissão 0600).
Atenção: o backup fica no mesmo disco do servidor. Se o servidor for perdido, os backups vão junto. Copie os arquivos para outro lugar (outro servidor, storage S3 etc.) com uma rotina sua.
Configurar o backup automático
No topo da tela há o formulário de configuração:
| Campo | O que faz | Padrão |
|---|---|---|
| Backup automatico | Liga o backup diário de todas as contas. | Desligado |
| Hora do dia | Hora (0 a 23) em que o backup diário começa. | 3 |
| Manter (copias) | Quantas cópias mais recentes guardar por conta (1 a 90). | 7 |
| Incluir bancos locais | Faz dump dos bancos MySQL/MariaDB e PostgreSQL da conta. | Marcado |
| Incluir vendor/node_modules | Inclui dependências de PHP e Node no arquivo. | Desmarcado |
Passos:
- Marque Backup automatico.
- Escolha a Hora do dia. Prefira um horário de pouco acesso.
- Defina quantas cópias Manter (copias).
- Marque ou desmarque as opções de inclusão.
- Clique em Salvar.
No horário escolhido, o painel faz o backup de todas as contas, uma de cada vez. Cada conta é copiada no máximo uma vez por dia pelo agendamento.
Retenção
Ao terminar um backup completo, o painel apaga as cópias mais antigas daquela conta e mantém só as mais recentes, no número definido em Manter (copias). A retenção também vale para backups feitos manualmente.
Um backup parcial (veja abaixo) não apaga nenhuma cópia antiga.
Fazer backup na hora
- Para uma conta: na linha da conta, clique em Backup agora.
- Para todas: clique em Backup de todos agora, no topo da tela, e confirme.
O backup manual usa as mesmas opções de inclusão salvas no formulário.
Enquanto o backup roda, aparece uma linha de progresso acima da tabela, com o usuário, o status e o tempo. A tela se atualiza sozinha a cada poucos segundos. Tarefas terminadas há mais de 24 horas somem dessa lista.
No máximo 2 backups rodam ao mesmo tempo. Com Backup de todos agora, as demais contas ficam com "na fila..." e começam conforme as anteriores terminam.
Status do backup
| Status | Significado |
|---|---|
| ok | Arquivos e bancos copiados. A retenção foi aplicada. |
| parcial | O dump de um ou mais bancos falhou. O arquivo foi guardado sem esses bancos, e as cópias antigas não foram apagadas, porque podem ser as únicas com o banco íntegro. O log mostra qual banco falhou. |
| erro | O empacotamento falhou. Nenhum arquivo pela metade fica guardado. |
Um backup parcial também aparece na Auditoria como backup_run com falha. Corrija a causa (banco parado, sem espaço, tabela corrompida) e rode o backup de novo.
Baixar e excluir backups
A tabela mostra, para cada conta, a lista de arquivos com tamanho e data.
- Clique no ícone de download para baixar o
.tar.gz. - Clique no ícone de lixeira para excluir uma cópia. O painel pede confirmação.
Restaurar um backup
A restauração é manual. Não há botão de "restaurar" no painel.
- Baixe o
.tar.gzdesejado. - Extraia o arquivo em uma pasta temporária:
mkdir /root/restaura && cd /root/restaura
tar xzf usuario-20260101-030000.tar.gz
- Copie de volta os arquivos que precisa para
/home/<usuario>/, mantendo o dono da conta:
rsync -a /root/restaura/public_html/ /home/usuario/public_html/
chown -R usuario:usuario /home/usuario/public_html
- Para os bancos, use os arquivos em
db/. Os.sql.gzsão MySQL/MariaDB: importe pela tela Bancos de Dados ou commysql. Os.pgsql.gzsão PostgreSQL: importe compsql, conectando com o usuário dono do banco.
# MySQL/MariaDB
gunzip < db/usuario_loja.sql.gz | mysql usuario_loja
# PostgreSQL (o banco de destino precisa existir; pede a senha do usuário do banco)
gunzip -c db/usuario_app.pgsql.gz | psql -h 127.0.0.1 -U usuario_app -d usuario_app
Atenção: os dumps PostgreSQL são gerados sem dono (
--no-owner). Se você importar comopostgres(por exemplo, comsudo -u postgres psql), as tabelas ficam com donopostgrese a aplicação pode perder acesso a elas. Prefira importar com o usuário do banco, como no exemplo acima. Se já importou comopostgres, devolva a posse ao usuário do banco comREASSIGN OWNEDouALTER ... OWNER TO.
Atenção: importar um dump sobrescreve as tabelas do banco de destino. Se tiver dúvida, importe antes em um banco novo para conferir.