Backup

Tieni una copia della tua configurazione, da ripristinare dopo un cattivo aggiornamento, un disco rotto o il passaggio a un computer nuovo.

Prima di iniziare

• Settings > Backups (Impostazioni > Backup) richiede il permesso Change settings (cambiare le impostazioni). Solo il proprietario ripristina.
• Per scaricare, eliminare e ripristinare serve un accesso con password fatto negli ultimi minuti.

Fare un backup

1. Apri Settings > Backups.
2. Premi Back up now (fai il backup ora). Dovresti vedere il nuovo backup sotto Saved backups (backup salvati).
3. Premi Download (scarica) accanto al backup per tenerne una copia fuori dal server.

Salvare la chiave principale

I backup non contengono mai la chiave principale, che apre le password e le chiavi API nelle tue impostazioni. Senza la chiave corrispondente, un backup ripristinato non riesce a leggerle.

1. Sotto Master key (chiave principale), il proprietario preme Download key kit (scarica il kit della chiave).
2. Tieni il file lontano dal server e separato dai backup. Dovresti vedere l’avvertenza sul kit della chiave sparire da Settings > Backups e dai controlli di salute.

Per usarlo in seguito, rinominalo in holyarrs.key e mettilo nella cartella di configurazione. Non sei il proprietario? Chiedi al proprietario di scaricarlo.

Ripristinare un backup

Pericolo

Le modifiche fatte dopo il backup vanno perse. Tieni pronta prima la chiave principale corrispondente.

1. Premi Restore from a file (ripristina da un file) e scegli lo zip di un backup di HolyArrs.
2. Conferma.
3. HolyArrs controlla il file. Dovresti vedere Restore ready. It applies on the next start.
4. HolyArrs si riavvia e mette il backup al suo posto. Con il criterio di riavvio di Docker consigliato succede da solo.

I tuoi database attuali vengono spostati in /config/backups/before-restore-<time>, così puoi annullare un ripristino.

Scelte

Quanto spesso

Scelta	Fa il backup	Conserva
Balanced (bilanciato, predefinito)	Ogni giorno	Ultimi 7 giorni e 4 copie settimanali
Light (leggero)	Una volta a settimana	4 settimane. Occupa meno spazio
Careful (accurato)	Ogni giorno	Ogni copia per 30 giorni

Il backup pianificato più recente viene sempre conservato. Queste regole puliscono solo i backup pianificati. I backup che fai tu restano finché non li elimini (pulsante del cestino sulla riga; non si può annullare). HolyArrs fa anche un backup prima di un aggiornamento che cambia i dati salvati e tiene gli ultimi 3; vedi Aggiornamenti.

Passare a un computer nuovo

Una nuova installazione crea la propria chiave principale al primo avvio. Quella chiave non apre i tuoi vecchi backup, quindi il ripristino viene rifiutato. Metti prima al suo posto la vecchia chiave. Gli esempi chiamano il container holyarrs; usa il nome del tuo.

1. Prima del primo avvio, crea il container senza avviarlo: docker compose create, oppure la tua riga docker run con docker create al posto di docker run -d.
2. Copia dentro la vecchia chiave: docker cp holyarrs.key holyarrs:/config/. Va bene anche un kit della chiave rinominato in holyarrs.key. Funziona con un volume con nome o con una cartella dell’host; all’avvio HolyArrs passa i file in /config al tuo PUID e PGID. Se usi HOLYARRS_MASTER_KEY_FILE, metti invece la chiave in quel percorso sull’host, leggibile dal tuo PUID e PGID.
3. Ripristina il backup. Scegli una strada:

   • Avvia HolyArrs, completa il primo avvio, poi usa Restore from a file in Settings > Backups.

   • Oppure ripristina prima del primo avvio. Metti lo zip, con il nome invariato, in una cartella chiamata backups e copiala dentro con docker cp backups holyarrs:/config/. Poi esegui il ripristino una volta con la stessa immagine:

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

     Con il percorso di un file chiave, aggiungi -e HOLYARRS_MASTER_KEY_FILE=<its path> così il ripristino controlla con la tua chiave. restore --list mostra i nomi dei backup che riesce a vedere.

4. Avvia HolyArrs. Dovresti ritrovare la tua Libreria e le tue impostazioni.

Hai avviato la nuova installazione prima di copiare la chiave? Se non c’è nulla da salvare, arresta HolyArrs, copia la vecchia chiave sopra quella nuova con lo stesso docker cp, ripristina, poi avvia.

Se non funziona

Sintomo: “Backups are off in this build”. Causa: questa copia gira senza il suo gestore dei backup. Soluzione: nessuna nell’app; non ci sono controlli per i backup.

Sintomo: scaricare, eliminare o ripristinare ti chiede la password. Causa: servono un accesso con password recente. Soluzione: accedi di nuovo con la password e riprova.

Sintomo: il ripristino viene rifiutato a causa della chiave principale. Causa: la chiave nella cartella di configurazione non corrisponde al backup. Soluzione: rimetti al suo posto il holyarrs.key giusto e riprova.

Il ripristino rifiuta anche uno zip troppo grande o danneggiato, con file inattesi, creato da una versione del database più recente, o con dati che la tua chiave non riesce a leggere.

Per esperti

Cosa c'è in un backup

Ogni backup è uno zip con il database principale, il database Events se c’è, e backup.json (versione di HolyArrs, versioni dei database, tipo di backup, ora in cui è stato fatto). File multimediali, download, immagini, log e chiave principale non ci sono.

Ripristinare prima del primo avvio

docker cp funziona con un volume con nome o con una cartella dell’host; all’avvio HolyArrs passa i file in /config al tuo PUID e PGID. Con HOLYARRS_MASTER_KEY_FILE, metti invece la chiave in quel percorso sull’host, leggibile da PUID e PGID.

1. Metti lo zip, con il nome invariato, in una cartella chiamata backups e copiala dentro: docker cp backups holyarrs:/config/.
2. Esegui il ripristino una volta con la stessa immagine:
   • 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. Con il percorso di un file chiave, aggiungi -e HOLYARRS_MASTER_KEY_FILE=<its path> così il ripristino controlla con la tua chiave.
4. Avvia HolyArrs.

restore --list mostra i nomi dei backup che riesce a vedere.

Correlati

• Aggiornamenti
• Installazione
• Controlli di salute