Backups

Guarde uma cópia da sua configuração para recuperar depois de uma atualização ruim, de um disco com defeito ou de uma mudança para um computador novo.

Antes de começar

• Settings > Backups (configurações > backups) exige a permissão Change settings (alterar configurações). Só o dono restaura.
• Baixar, excluir e restaurar exigem um login com senha feito nos últimos minutos.

Fazer um backup

1. Abra Settings > Backups.
2. Clique em Back up now (fazer backup agora). Você deve ver o novo backup em Saved backups (backups salvos).
3. Clique em Download (baixar) ao lado dele para guardar uma cópia fora do servidor.

Salvar a chave mestra

Os backups nunca levam a chave mestra, que abre as senhas e as chaves de API das suas configurações. Sem a chave correspondente, um backup restaurado não consegue ler esses dados.

1. Em Master key (chave mestra), o dono clica em Download key kit (baixar kit da chave).
2. Guarde o arquivo longe do servidor e separado dos seus backups. Você deve ver o aviso do kit da chave sumir de Settings > Backups e das verificações de saúde.

Para usar o arquivo mais tarde, renomeie para holyarrs.key e coloque na pasta de configuração. Não é o dono? Peça ao dono para baixar.

Restaurar um backup

Perigo

As mudanças feitas depois do backup são perdidas. Tenha a chave mestra correspondente em mãos antes.

1. Clique em Restore from a file (restaurar de um arquivo) e escolha um zip de backup do HolyArrs.
2. Confirme.
3. O HolyArrs verifica o arquivo. Você deve ver Restore ready. It applies on the next start. (restauração pronta; ela é aplicada na próxima inicialização).
4. O HolyArrs reinicia e coloca o backup no lugar. Com a política de reinício recomendada do Docker, isso acontece sozinho.

Seus bancos de dados atuais vão para /config/backups/before-restore-<time>, então você pode desfazer uma restauração.

Opções

Com que frequência

Opção	Faz backup	Guarda
Balanced (equilibrado, padrão)	Todo dia	Os últimos 7 dias e 4 cópias semanais
Light (leve)	Uma vez por semana	4 semanas. Ocupa menos espaço
Careful (cuidadoso)	Todo dia	Todas as cópias por 30 dias

O backup agendado mais novo sempre fica. Essas regras limpam só os backups agendados. Os backups que você faz ficam até você excluir (botão da lixeira na linha; não dá para desfazer). O HolyArrs também faz backup antes de uma atualização que muda os dados guardados e mantém os 3 mais novos; veja Atualizações.

Mudar para um computador novo

Uma instalação nova cria sua própria chave mestra na primeira inicialização. Essa chave não abre seus backups antigos, então a restauração é recusada. Coloque a chave antiga no lugar antes. Os exemplos chamam o container de holyarrs; use o nome do seu.

1. Antes da primeira inicialização, crie o container sem iniciar: docker compose create, ou sua linha de docker run com docker create no lugar de docker run -d.
2. Copie sua chave antiga para dentro: docker cp holyarrs.key holyarrs:/config/. Um kit da chave renomeado para holyarrs.key também serve. Isso funciona com um volume nomeado ou com uma pasta do host; o HolyArrs entrega os arquivos de /config ao seu PUID e PGID quando inicia. Se você usa HOLYARRS_MASTER_KEY_FILE, coloque a chave nesse caminho no host, com leitura para seu PUID e PGID.
3. Restaure o backup. Escolha um jeito:

   • Inicie o HolyArrs, termine a primeira execução e depois use Restore from a file em Settings > Backups.

   • Ou restaure antes da primeira inicialização. Coloque o zip, sem mudar o nome, em uma pasta chamada backups e copie para dentro com docker cp backups holyarrs:/config/. Depois execute a restauração uma vez com a mesma imagem:

     • Compose: docker compose run --rm holyarrs restore <zip name>
     • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>

     Com um caminho de arquivo de chave, adicione -e HOLYARRS_MASTER_KEY_FILE=<its path> para a restauração conferir com a sua chave. restore --list mostra os nomes dos backups que ele enxerga.

4. Inicie o HolyArrs. Você deve ver sua Biblioteca e suas configurações de volta.

Iniciou a instalação nova antes de copiar a chave? Se não há nada nela que valha guardar, pare o HolyArrs, copie sua chave antiga por cima da nova com o mesmo docker cp, restaure e depois inicie.

Se não funcionar

Sintoma: “Backups are off in this build” (os backups estão desativados nesta versão). Causa: esta cópia roda sem o gerenciador de backups. Solução: nenhuma no app; não há controles de backup.

Sintoma: baixar, excluir ou restaurar pede sua senha. Causa: essas ações exigem um login recente com senha. Solução: entre de novo com sua senha e tente outra vez.

Sintoma: a restauração é recusada por causa da chave mestra. Causa: a chave na pasta de configuração não corresponde ao backup. Solução: coloque de volta o holyarrs.key correspondente e tente de novo.

A restauração também recusa um zip grande demais ou danificado, com arquivos inesperados, vindo de uma versão mais nova do banco de dados ou com dados que sua chave não consegue ler.

Para especialistas

O que há em um backup

Cada backup é um zip com o banco de dados principal, o banco de dados de eventos, se existir, e o backup.json (versão do HolyArrs, versões dos bancos de dados, tipo de backup, hora em que foi feito). Mídia, downloads, imagens, logs e a chave mestra não entram.

Restaurar antes da primeira inicialização

docker cp funciona com um volume nomeado ou com uma pasta do host; o HolyArrs entrega os arquivos de /config ao seu PUID e PGID quando inicia. Com HOLYARRS_MASTER_KEY_FILE, coloque a chave nesse caminho do host, com leitura para PUID e PGID.

1. Coloque o zip, sem mudar o nome, em uma pasta chamada backups e copie para dentro: docker cp backups holyarrs:/config/.
2. Execute a restauração uma vez com a mesma imagem:
   • Compose: docker compose run --rm holyarrs restore <zip name>
   • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>
3. Com um caminho de arquivo de chave, adicione -e HOLYARRS_MASTER_KEY_FILE=<its path> para a restauração conferir com a sua chave.
4. Inicie o HolyArrs.

restore --list mostra os nomes dos backups que ele enxerga.

Relacionados

• Atualizações
• Instalação
• Verificações de saúde