Cópias de segurança

Guarda uma cópia da tua configuração para a repor depois de uma má atualização, de um disco avariado ou de uma mudança para um computador novo.

Antes de começares

• Settings > Backups (Definições > Cópias de segurança) precisa da permissão Change settings (alterar definições). Só o proprietário restaura.
• Transferir, apagar e restaurar precisam de um início de sessão com palavra-passe feito há poucos minutos.

Fazer uma cópia de segurança

1. Abre Settings > Backups.
2. Clica em Back up now (fazer cópia agora). Deves ver a cópia nova em Saved backups (cópias guardadas).
3. Clica em Download (transferir) ao lado dela para guardares uma cópia fora do servidor.

Guardar a chave mestra

As cópias de segurança nunca incluem a chave mestra, que abre as palavras-passe e as chaves de API das tuas definições. Sem a chave certa, uma cópia restaurada não as consegue ler.

1. Em Master key (chave mestra), o proprietário clica em Download key kit (transferir o kit de chaves).
2. Guarda o ficheiro longe do servidor e separado das tuas cópias de segurança. Deves ver o aviso do kit de chaves desaparecer de Settings > Backups e das verificações de saúde.

Para o usares mais tarde, muda-lhe o nome para holyarrs.key e põe-no na pasta de configuração. Não és o proprietário? Pede-lhe que o transfira.

Restaurar uma cópia de segurança

Perigo

As alterações feitas depois da cópia perdem-se. Tem primeiro à mão a chave mestra correspondente.

1. Clica em Restore from a file (restaurar a partir de um ficheiro) e escolhe um zip de cópia de segurança do HolyArrs.
2. Confirma.
3. O HolyArrs verifica o ficheiro. Deves ver Restore ready. It applies on the next start. (restauro pronto, aplica-se no próximo arranque).
4. O HolyArrs reinicia e põe a cópia no sítio. Com a política de reinício recomendada para o Docker, isto acontece sozinho.

As tuas bases de dados atuais passam para /config/backups/before-restore-<time>, por isso podes anular um restauro.

Opções

Com que frequência

Opção	Faz cópia	Guarda
Balanced (equilibrado, predefinido)	Todos os dias	Últimos 7 dias e 4 cópias semanais
Light (leve)	Uma vez por semana	4 semanas. Ocupa menos espaço
Careful (cuidadoso)	Todos os dias	Todas as cópias durante 30 dias

A cópia agendada mais recente fica sempre guardada. Estas regras só limpam as cópias agendadas. As cópias que fazes tu ficam até as apagares (botão do lixo na linha; não dá para anular). O HolyArrs também faz uma cópia antes de uma atualização que altere dados guardados e mantém as 3 mais recentes; vê Atualizações.

Mudar para um computador novo

Uma instalação nova cria a sua própria chave mestra no primeiro arranque. Essa chave não abre as tuas cópias antigas, por isso o restauro é recusado. Põe primeiro a chave antiga no sítio. Os exemplos chamam holyarrs ao contentor; usa o nome do teu.

1. Antes do primeiro arranque, cria o contentor sem o iniciar: docker compose create, ou a tua linha docker run com docker create no lugar de docker run -d.
2. Copia a tua chave antiga para lá: docker cp holyarrs.key holyarrs:/config/. Um kit de chaves com o nome mudado para holyarrs.key também serve. Isto funciona com um volume com nome ou com uma pasta do host; o HolyArrs passa os ficheiros de /config para o teu PUID e PGID quando arranca. Se usas HOLYARRS_MASTER_KEY_FILE, põe antes a chave nesse caminho do host, legível pelo teu PUID e PGID.
3. Restaura a cópia de segurança. Escolhe uma das formas:

   • Inicia o HolyArrs, termina a primeira execução e depois usa Restore from a file em Settings > Backups.

   • Ou restaura antes do primeiro arranque. Põe o zip, com o nome sem alterações, numa pasta chamada backups e copia-a para lá com docker cp backups holyarrs:/config/. Depois executa o restauro 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 o caminho de um ficheiro de chave, acrescenta -e HOLYARRS_MASTER_KEY_FILE=<its path> para o restauro verificar com a tua chave. restore --list mostra os nomes das cópias que consegue ver.

4. Inicia o HolyArrs. Deves ver a tua Biblioteca e as tuas definições de volta.

Iniciaste a instalação nova antes de copiares a chave? Se não houver nada nela que valha a pena guardar, para o HolyArrs, copia a tua chave antiga por cima da nova com o mesmo docker cp, restaura e depois inicia.

Se não funcionar

Sintoma: “Backups are off in this build”. Causa: esta cópia corre sem o seu gestor de cópias de segurança. Solução: não há solução na app; não existem controlos de cópias de segurança.

Sintoma: transferir, apagar ou restaurar pede a tua palavra-passe. Causa: estas ações precisam de um início de sessão recente com palavra-passe. Solução: inicia sessão outra vez com a tua palavra-passe e tenta de novo.

Sintoma: o restauro é recusado por causa da chave mestra. Causa: a chave na pasta de configuração não corresponde à cópia de segurança. Solução: repõe o holyarrs.key correto e tenta de novo.

O restauro também recusa um zip que seja demasiado grande ou esteja danificado, tenha ficheiros inesperados, venha de uma versão mais recente da base de dados ou tenha dados que a tua chave não consegue ler.

Para especialistas

O que há numa cópia de segurança

Cada cópia de segurança é um zip com a base de dados principal, a base de dados de Eventos, se existir, e backup.json (versão do HolyArrs, versões das bases de dados, tipo de cópia, hora a que foi feita). Multimédia, transferências, imagens, registos e a chave mestra não estão lá.

Restaurar antes do primeiro arranque

docker cp funciona com um volume com nome ou com uma pasta do host; o HolyArrs passa os ficheiros de /config para o teu PUID e PGID quando arranca. Com HOLYARRS_MASTER_KEY_FILE, põe antes a chave nesse caminho do host, legível por PUID e PGID.

1. Põe o zip, com o nome sem alterações, numa pasta chamada backups e copia-a para lá: docker cp backups holyarrs:/config/.
2. Executa o restauro 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 o caminho de um ficheiro de chave, acrescenta -e HOLYARRS_MASTER_KEY_FILE=<its path> para o restauro verificar com a tua chave.
4. Inicia o HolyArrs.

restore --list mostra os nomes das cópias que consegue ver.

Relacionado

• Atualizações
• Instalar
• Verificações de saúde