Copii de rezervă

Păstrează o copie a configurării tale, ca s-o readuci după o actualizare proastă, un disc stricat sau o mutare pe un aparat nou.

Înainte să începi

• Settings > Backups (Setări > Copii de rezervă) cere permisiunea Change settings (modifică setările). Doar proprietarul restaurează.
• Descărcarea, ștergerea și restaurarea cer o conectare cu parolă din ultimele minute.

Fă o copie de rezervă

1. Deschide Settings > Backups.
2. Apasă Back up now (fă o copie acum). Ar trebui să vezi copia nouă sub Saved backups (copii salvate).
3. Apasă Download (descarcă) lângă ea, ca să păstrezi o copie în afara serverului.

Salvează cheia principală

Copiile de rezervă nu conțin niciodată cheia principală, cea care deschide parolele și cheile API din setările tale. Fără cheia potrivită, o copie restaurată nu le poate citi.

1. Sub Master key (cheia principală), proprietarul apasă Download key kit (descarcă kitul de chei).
2. Ține fișierul departe de server și separat de copiile tale de rezervă. Ar trebui să vezi avertismentul despre kitul de chei dispărând din Settings > Backups și din verificările de sănătate.

Ca să-l folosești mai târziu, redenumește-l în holyarrs.key și pune-l în dosarul de configurare. Nu ești proprietarul? Roagă-l pe proprietar să-l descarce.

Restaurează o copie de rezervă

Pericol

Modificările făcute după copia de rezervă se pierd. Ține la îndemână cheia principală potrivită înainte să începi.

1. Apasă Restore from a file (restaurează dintr-un fișier) și alege un zip de copie HolyArrs.
2. Confirmă.
3. HolyArrs verifică fișierul. Ar trebui să vezi Restore ready. It applies on the next start. (restaurarea e gata; se aplică la următoarea pornire).
4. HolyArrs repornește și pune copia la locul ei. Cu politica de repornire Docker recomandată, asta se întâmplă singur.

Bazele tale de date actuale se mută în /config/backups/before-restore-<time>, așa că poți anula o restaurare.

Alegeri

Cât de des

Alegere	Copie	Păstrează
Balanced (echilibrat, implicit)	În fiecare zi	Ultimele 7 zile și 4 copii săptămânale
Light (ușor)	O dată pe săptămână	4 săptămâni. Cel mai puțin spațiu
Careful (atent)	În fiecare zi	Fiecare copie timp de 30 de zile

Cea mai nouă copie programată se păstrează întotdeauna. Aceste reguli curăță doar copiile programate. Copiile pe care le faci tu rămân până le ștergi (butonul de coș de pe rând; nu se poate anula). HolyArrs face o copie și înainte de o actualizare care schimbă datele stocate și le păstrează pe ultimele 3; vezi Actualizări.

Mută pe un aparat nou

O instalare nouă își face propria cheie principală la prima pornire. Cheia aceea nu poate deschide copiile tale vechi, așa că restaurarea e refuzată. Pune mai întâi cheia veche la locul ei. Exemplele numesc containerul holyarrs; folosește numele tău.

1. Înainte de prima pornire, creează containerul fără să-l pornești: docker compose create, sau linia ta docker run cu docker create în loc de docker run -d.
2. Copiază cheia veche înăuntru: docker cp holyarrs.key holyarrs:/config/. Merge și un kit de chei redenumit în holyarrs.key. Merge pentru un volum cu nume sau pentru un dosar de pe gazdă; HolyArrs dă fișierele din /config lui PUID și PGID când pornește. Dacă folosești HOLYARRS_MASTER_KEY_FILE, pune în schimb cheia la calea aceea de pe gazdă, cu drept de citire pentru PUID și PGID.
3. Restaurează copia. Alege un mod:

   • Pornește HolyArrs, termină prima pornire, apoi folosește Restore from a file în Settings > Backups.

   • Sau restaurează înainte de prima pornire. Pune zip-ul, cu numele neschimbat, într-un dosar numit backups și copiază-l înăuntru cu docker cp backups holyarrs:/config/. Apoi rulează restaurarea o dată, cu aceeași imagine:

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

     Dacă folosești o cale de fișier cu cheia, adaugă -e HOLYARRS_MASTER_KEY_FILE=<its path> ca restaurarea să verifice cu cheia ta. restore --list arată numele copiilor pe care le vede.

4. Pornește HolyArrs. Ar trebui să vezi Biblioteca și setările tale înapoi.

Ai pornit instalarea nouă înainte să copiezi cheia? Dacă nu e nimic de păstrat pe ea, oprește HolyArrs, copiază cheia veche peste cea nouă cu același docker cp, restaurează, apoi pornește.

Dacă nu merge

Simptom: „Backups are off in this build“. Cauză: această copie rulează fără managerul ei de copii de rezervă. Soluție: nu există una în aplicație; nu sunt comenzi pentru copii de rezervă.

Simptom: descărcarea, ștergerea sau restaurarea îți cere parola. Cauză: acestea cer o conectare recentă cu parolă. Soluție: conectează-te din nou cu parola și încearcă iar.

Simptom: restaurarea e refuzată din cauza cheii principale. Cauză: cheia din dosarul de configurare nu se potrivește cu copia. Soluție: pune la loc holyarrs.key cea potrivită și încearcă iar.

Restaurarea refuză și un zip care e prea mare sau stricat, conține fișiere neașteptate, vine dintr-o versiune mai nouă a bazei de date sau are date pe care cheia ta nu le poate citi.

Pentru experți

Ce conține o copie de rezervă

Fiecare copie e un zip cu baza de date principală, baza de date Events dacă există una, și backup.json (versiunea HolyArrs, versiunile bazelor de date, tipul copiei, ora la care a fost făcută). Media, descărcările, imaginile, jurnalele și cheia principală nu sunt incluse.

Restaurare înainte de prima pornire

docker cp merge pentru un volum cu nume sau pentru un dosar de pe gazdă; HolyArrs dă fișierele din /config lui PUID și PGID când pornește. Cu HOLYARRS_MASTER_KEY_FILE, pune în schimb cheia la calea aceea de pe gazdă, cu drept de citire pentru PUID și PGID.

1. Pune zip-ul, cu numele neschimbat, într-un dosar numit backups și copiază-l înăuntru: docker cp backups holyarrs:/config/.
2. Rulează restaurarea o dată, cu aceeași imagine:
   • 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. Dacă folosești o cale de fișier cu cheia, adaugă -e HOLYARRS_MASTER_KEY_FILE=<its path> ca restaurarea să verifice cu cheia ta.
4. Pornește HolyArrs.

restore --list arată numele copiilor pe care le vede.

Vezi și

• Actualizări
• Instalare
• Verificări de sănătate