Backupi

Čuvaj kopiju svojih postavki da ih možeš vratiti nakon lošeg ažuriranja, pokvarenog diska ili selidbe na novo računalo.

Prije nego počneš

• Settings > Backups (postavke > backupi) traži dozvolu Change settings (mijenjanje postavki). Samo vlasnik vraća podatke.
• Preuzimanje, brisanje i vraćanje traže prijavu lozinkom u posljednjih nekoliko minuta.

Napravi backup

1. Otvori Settings > Backups.
2. Klikni na Back up now (napravi backup sada). Vidjet ćeš novi backup pod Saved backups (spremljeni backupi).
3. Klikni na Download (preuzmi) pokraj njega da kopiju čuvaš izvan servera.

Spremi glavni ključ

Backupi nikad ne sadrže glavni ključ, koji otvara lozinke i API ključeve u tvojim postavkama. Bez odgovarajućeg ključa vraćeni backup ih ne može pročitati.

1. Pod Master key (glavni ključ) vlasnik klikne na Download key kit (preuzmi paket s ključem).
2. Čuvaj datoteku podalje od servera i odvojeno od backupa. Vidjet ćeš da upozorenje o paketu s ključem nestaje iz Settings > Backups i iz provjera stanja.

Kad ga kasnije želiš upotrijebiti, preimenuj ga u holyarrs.key i stavi u mapu s konfiguracijom. Nisi vlasnik? Zamoli vlasnika da ga preuzme.

Vrati backup

Danger

Promjene napravljene nakon backupa gube se. Prvo pripremi odgovarajući glavni ključ.

1. Klikni na Restore from a file (vrati iz datoteke) i odaberi HolyArrs backup zip.
2. Potvrdi.
3. HolyArrs provjeri datoteku. Vidjet ćeš Restore ready. It applies on the next start.
4. HolyArrs se ponovno pokrene i postavi backup na mjesto. S preporučenim Docker pravilom ponovnog pokretanja to se dogodi samo od sebe.

Tvoje trenutne baze podataka premještaju se u /config/backups/before-restore-<time>, pa možeš poništiti vraćanje.

Izbori

Koliko često

Izbor	Backup	Čuva
Balanced (uravnoteženo, zadano)	Svaki dan	Zadnjih 7 dana i 4 tjedne kopije
Light (lagano)	Jednom tjedno	4 tjedna. Najmanje prostora
Careful (oprezno)	Svaki dan	Svaku kopiju 30 dana

Najnoviji raspoređeni backup uvijek se čuva. Ova pravila čiste samo raspoređene backupe. Backupi koje sam napraviš ostaju dok ih ne izbrišeš (gumb koša na retku; to se ne može poništiti). HolyArrs također radi backup prije ažuriranja koje mijenja spremljene podatke i čuva 3 najnovija; vidi Ažuriranja.

Prelazak na novo računalo

Nova instalacija pri prvom pokretanju stvara vlastiti glavni ključ. Taj ključ ne može otvoriti tvoje stare backupe pa se vraćanje odbija. Prvo postavi stari ključ. Primjeri container zovu holyarrs; upiši svoje ime.

1. Prije prvog pokretanja stvori container bez pokretanja: docker compose create ili svoju docker run liniju s docker create umjesto docker run -d.
2. Kopiraj svoj stari ključ unutra: docker cp holyarrs.key holyarrs:/config/. Radi i paket s ključem preimenovan u holyarrs.key. Ovo radi za named volume ili mapu na hostu; HolyArrs pri pokretanju predaje datoteke u /config tvojim PUID i PGID. Ako koristiš HOLYARRS_MASTER_KEY_FILE, stavi ključ na tu putanju na hostu, čitljiv za tvoje PUID i PGID.
3. Vrati backup. Odaberi jedan način:

   • Pokreni HolyArrs, završi prvo pokretanje, pa u Settings > Backups upotrijebi Restore from a file.

   • Ili vrati prije prvog pokretanja. Stavi zip, s nepromijenjenim imenom, u mapu backups i kopiraj je unutra s docker cp backups holyarrs:/config/. Zatim jednom izvrši vraćanje s istim imageom:

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

     Ako koristiš putanju do datoteke s ključem, dodaj -e HOLYARRS_MASTER_KEY_FILE=<its path> da vraćanje provjerava prema tvom ključu. restore --list prikazuje imena backupa koje vidi.

4. Pokreni HolyArrs. Vidjet ćeš da su se biblioteka i postavke vratile.

Je li nova instalacija pokrenuta prije kopiranja ključa? Ako na njoj nema ničega vrijednog čuvanja, zaustavi HolyArrs, kopiraj stari ključ preko novog istim docker cp, vrati backup i pokreni.

Ako ne radi

Simptom: „Backups are off in this build“. Uzrok: ova kopija radi bez svog upravitelja backupa. Rješenje: nema rješenja u aplikaciji; nema kontrola za backup.

Simptom: preuzimanje, brisanje ili vraćanje traži tvoju lozinku. Uzrok: za to je potrebna nedavna prijava lozinkom. Rješenje: prijavi se ponovno lozinkom i pokušaj opet.

Simptom: vraćanje se odbija zbog glavnog ključa. Uzrok: ključ u mapi s konfiguracijom ne odgovara backupu. Rješenje: vrati odgovarajući holyarrs.key i pokušaj ponovno.

Vraćanje odbija i zip koji je prevelik ili oštećen, sadrži neočekivane datoteke, dolazi iz novije verzije baze podataka ili sadrži podatke koje tvoj ključ ne može pročitati.

Za napredne

Što je u backupu

Svaki backup je zip s glavnom bazom podataka, bazom Events ako postoji i datotekom backup.json (verzija HolyArrs-a, verzije baza, vrsta backupa, vrijeme izrade). Mediji, preuzimanja, artwork, logovi i glavni ključ nisu u njemu.

Vraćanje prije prvog pokretanja

docker cp radi za named volume ili mapu na hostu; HolyArrs pri pokretanju predaje datoteke u /config tvojim PUID i PGID. Uz HOLYARRS_MASTER_KEY_FILE stavi ključ na tu putanju na hostu, čitljiv za PUID i PGID.

1. Stavi zip, s nepromijenjenim imenom, u mapu backups i kopiraj je unutra: docker cp backups holyarrs:/config/.
2. Jednom izvrši vraćanje s istim imageom:
   • 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. Ako koristiš putanju do datoteke s ključem, dodaj -e HOLYARRS_MASTER_KEY_FILE=<its path> da vraćanje provjerava prema tvom ključu.
4. Pokreni HolyArrs.

restore --list prikazuje imena backupa koje vidi.

Povezane stranice

• Ažuriranja
• Instalacija
• Provjere stanja