Pular para o conteúdo
Documentação

Backups das contas

Como o miniCP gera, agenda, guarda e restaura backups de arquivos e bancos MySQL de cada conta.

R Regis Manze 20/11/2026 6 min de leitura

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, tmp e logs na raiz da home;
  • caches de aplicação (var/cache, var/page_cache, var/session dentro dos sites);
  • .npm e .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:

  1. Marque Backup automatico.
  2. Escolha a Hora do dia. Prefira um horário de pouco acesso.
  3. Defina quantas cópias Manter (copias).
  4. Marque ou desmarque as opções de inclusão.
  5. 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.

  1. Baixe o .tar.gz desejado.
  2. Extraia o arquivo em uma pasta temporária:
mkdir /root/restaura && cd /root/restaura
tar xzf usuario-20260101-030000.tar.gz
  1. 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
  1. Para os bancos, use os arquivos em db/. Os .sql.gz são MySQL/MariaDB: importe pela tela Bancos de Dados ou com mysql. Os .pgsql.gz são PostgreSQL: importe com psql, 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 como postgres (por exemplo, com sudo -u postgres psql), as tabelas ficam com dono postgres e a aplicação pode perder acesso a elas. Prefira importar com o usuário do banco, como no exemplo acima. Se já importou como postgres, devolva a posse ao usuário do banco com REASSIGN OWNED ou ALTER ... 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.

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!