Còpies de seguretat

Guarda una còpia de la teva configuració per recuperar-la després d’una mala actualització, d’un disc espatllat o d’un canvi a un equip nou.

Abans de començar

• Settings > Backups (Paràmetres > Còpies de seguretat) necessita el permís Change settings (canviar paràmetres). Només el propietari restaura.
• Baixar, eliminar i restaurar necessiten haver iniciat la sessió amb contrasenya fa pocs minuts.

Fes una còpia de seguretat

1. Obre Settings > Backups.
2. Clica a Back up now (fes la còpia ara). Hauries de veure la còpia nova sota Saved backups (còpies desades).
3. Clica a Download (baixar) al costat per tenir-ne una còpia fora del servidor.

Desa la clau mestra

Les còpies de seguretat mai no inclouen la clau mestra, que obre les contrasenyes i les claus d’API dels teus paràmetres. Sense la clau corresponent, una còpia restaurada no les pot llegir.

1. A Master key (clau mestra), el propietari clica a Download key kit (baixar el paquet de la clau).
2. Guarda el fitxer lluny del servidor i separat de les teves còpies de seguretat. Hauries de veure que l’advertència del paquet de la clau desapareix de Settings > Backups i de les comprovacions de salut.

Per fer-lo servir més endavant, canvia-li el nom a holyarrs.key i posa’l a la carpeta de configuració. No ets el propietari? Demana-li que el baixi.

Restaura una còpia de seguretat

Perill

Es perden els canvis fets des de la còpia. Tingues a punt la clau mestra corresponent abans de començar.

1. Clica a Restore from a file (restaurar des d’un fitxer) i tria un zip de còpia de seguretat d’HolyArrs.
2. Confirma.
3. HolyArrs comprova el fitxer. Hauries de veure Restore ready. It applies on the next start. (restauració a punt; s’aplica al proper inici).
4. HolyArrs es reinicia i posa la còpia al seu lloc. Amb la política de reinici de Docker recomanada, això passa sol.

Les teves bases de dades actuals passen a /config/backups/before-restore-<time>, així que pots desfer una restauració.

Opcions

Amb quina freqüència

Opció	Fa la còpia	Conserva
Balanced (equilibrat, per defecte)	Cada dia	Els últims 7 dies i 4 còpies setmanals
Light (lleuger)	Un cop per setmana	4 setmanes. Ocupa menys espai
Careful (acurat)	Cada dia	Totes les còpies durant 30 dies

La còpia programada més recent sempre es conserva. Aquestes regles només netegen les còpies programades. Les còpies que fas tu es queden fins que les eliminis (botó de la paperera a la fila; no es pot desfer). HolyArrs també fa una còpia abans d’una actualització que canvia dades desades i conserva les 3 més noves; consulta Actualitzacions.

Canvia a un equip nou

Una instal·lació nova crea la seva pròpia clau mestra al primer inici. Aquesta clau no pot obrir les teves còpies antigues, així que la restauració es rebutja. Posa primer la clau antiga al seu lloc. Els exemples anomenen el contenidor holyarrs; fes servir el teu nom.

1. Abans del primer inici, crea el contenidor sense iniciar-lo: docker compose create, o la teva línia docker run amb docker create en lloc de docker run -d.
2. Copia-hi la clau antiga: docker cp holyarrs.key holyarrs:/config/. Un paquet de clau amb el nom canviat a holyarrs.key també serveix. Això funciona amb un volum amb nom o una carpeta del host; HolyArrs passa els fitxers de /config al teu PUID i PGID quan s’inicia. Si fas servir HOLYARRS_MASTER_KEY_FILE, posa la clau a aquesta ruta del host, llegible pel teu PUID i PGID.
3. Restaura la còpia. Tria una de les dues maneres:

   • Inicia HolyArrs, acaba el primer inici i després fes servir Restore from a file a Settings > Backups.

   • O restaura abans del primer inici. Posa el zip, sense canviar-li el nom, en una carpeta anomenada backups i copia-la amb docker cp backups holyarrs:/config/. Després executa la restauració una vegada amb la mateixa imatge:

     • 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>

     Si fas servir una ruta de fitxer de clau, afegeix -e HOLYARRS_MASTER_KEY_FILE=<its path> perquè la restauració comprovi amb la teva clau. restore --list mostra els noms de les còpies que veu.

4. Inicia HolyArrs. Hauries de veure la teva Biblioteca i els teus paràmetres de nou.

Has iniciat la instal·lació nova abans de copiar la clau? Si no hi ha res que valgui la pena conservar, atura HolyArrs, copia la clau antiga sobre la nova amb el mateix docker cp, restaura i després inicia.

Si no funciona

Símptoma: “Backups are off in this build” (les còpies estan desactivades en aquesta versió). Causa: aquesta còpia d’HolyArrs funciona sense el gestor de còpies de seguretat. Solució: cap dins l’app; no hi ha controls de còpia de seguretat.

Símptoma: baixar, eliminar o restaurar et demana la contrasenya. Causa: aquestes accions necessiten haver iniciat la sessió amb contrasenya fa poc. Solució: torna a iniciar la sessió amb la contrasenya i prova-ho de nou.

Símptoma: la restauració es rebutja per la clau mestra. Causa: la clau de la carpeta de configuració no coincideix amb la còpia. Solució: torna a posar el holyarrs.key corresponent i prova-ho de nou.

La restauració també rebutja un zip massa gran o malmès, que té fitxers inesperats, que ve d’una versió de base de dades més nova, o que conté dades que la teva clau no pot llegir.

Per a experts

Què hi ha en una còpia de seguretat

Cada còpia és un zip amb la base de dades principal, la base de dades d’Events si n’hi ha, i backup.json (versió d’HolyArrs, versions de les bases de dades, tipus de còpia, hora en què es va fer). Els mitjans, les baixades, les il·lustracions, els registres i la clau mestra no hi són.

Restaura abans del primer inici

docker cp funciona amb un volum amb nom o una carpeta del host; HolyArrs passa els fitxers de /config al teu PUID i PGID quan s’inicia. Amb HOLYARRS_MASTER_KEY_FILE, posa la clau a aquesta ruta del host, llegible pel PUID i PGID.

1. Posa el zip, sense canviar-li el nom, en una carpeta anomenada backups i copia-la: docker cp backups holyarrs:/config/.
2. Executa la restauració una vegada amb la mateixa imatge:
   • 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. Si fas servir una ruta de fitxer de clau, afegeix -e HOLYARRS_MASTER_KEY_FILE=<its path> perquè la restauració comprovi amb la teva clau.
4. Inicia HolyArrs.

restore --list mostra els noms de les còpies que veu.

Relacionat

• Actualitzacions
• Instal·lació
• Comprovacions de salut