Zálohy

Maj po ruke kópiu svojho nastavenia, aby si ju mohol vrátiť po zlej aktualizácii, pokazenom disku alebo presune na nový počítač.

Skôr než začneš

• Settings > Backups (nastavenia > zálohy) vyžaduje oprávnenie Change settings (meniť nastavenia). Obnovovať môže iba vlastník.
• Stiahnutie, vymazanie a obnova vyžadujú prihlásenie heslom z posledných pár minút.

Vytvor zálohu

1. Otvor Settings > Backups.
2. Klikni na Back up now (zálohovať teraz). Novú zálohu by si mal vidieť v zozname Saved backups (uložené zálohy).
3. Klikni vedľa nej na Download (stiahnuť), aby si mal kópiu mimo servera.

Ulož hlavný kľúč

Zálohy nikdy neobsahujú hlavný kľúč, ktorý odomyká heslá a kľúče API v tvojich nastaveniach. Bez zodpovedajúceho kľúča ich obnovená záloha nevie prečítať.

1. V časti Master key (hlavný kľúč) vlastník klikne na Download key kit (stiahnuť balík kľúča).
2. Uchovaj súbor mimo servera a oddelene od záloh. Varovanie o balíku kľúča by malo zmiznúť zo Settings > Backups aj z kontrol stavu.

Keď ho budeš neskôr potrebovať, premenuj ho na holyarrs.key a vlož ho do konfiguračného priečinka. Nie si vlastník? Požiadaj vlastníka, nech ho stiahne.

Obnov zálohu

Nebezpečenstvo

Zmeny urobené po vytvorení zálohy sa stratia. Najprv si priprav zodpovedajúci hlavný kľúč.

1. Klikni na Restore from a file (obnoviť zo súboru) a vyber zip so zálohou HolyArrs.
2. Potvrď.
3. HolyArrs súbor skontroluje. Mal by si vidieť Restore ready. It applies on the next start.
4. HolyArrs sa reštartuje a záloha sa nahrá. S odporúčanou politikou reštartu v Dockeri sa to stane samo.

Tvoje súčasné databázy sa presunú do /config/backups/before-restore-<time>, takže obnovu môžeš vrátiť.

Možnosti

Ako často

Možnosť	Zálohuje	Uchová
Balanced (vyvážené; predvolené)	Každý deň	Posledných 7 dní a 4 týždenné kópie
Light (úsporné)	Raz za týždeň	4 týždne. Najmenej miesta
Careful (opatrné)	Každý deň	Každú kópiu 30 dní

Najnovšia plánovaná záloha sa uchová vždy. Tieto pravidlá čistia iba plánované zálohy. Zálohy, ktoré vytvoríš sám, zostanú, kým ich nevymažeš (tlačidlo koša na riadku; nedá sa vrátiť späť). HolyArrs zálohuje aj pred aktualizáciou, ktorá mení uložené dáta, a uchová 3 najnovšie; pozri Aktualizácie.

Presun na nový počítač

Nová inštalácia si pri prvom spustení vytvorí vlastný hlavný kľúč. Ten nedokáže otvoriť tvoje staré zálohy, takže obnova sa zamietne. Najprv vlož na miesto starý kľúč. V príkladoch sa kontajner volá holyarrs; použi svoj názov.

1. Pred prvým spustením vytvor kontajner bez spustenia: docker compose create, alebo svoj riadok docker run s docker create namiesto docker run -d.
2. Skopíruj dnu starý kľúč: docker cp holyarrs.key holyarrs:/config/. Funguje aj balík kľúča premenovaný na holyarrs.key. Platí to pre pomenovaný volume aj priečinok na hostiteľovi; HolyArrs pri spustení odovzdá súbory v /config tvojmu PUID a PGID. Ak používaš HOLYARRS_MASTER_KEY_FILE, daj kľúč namiesto toho na túto cestu na hostiteľovi, čitateľný pre tvoj PUID a PGID.
3. Obnov zálohu. Vyber jeden spôsob:

   • Spusti HolyArrs, dokonči prvé spustenie a potom použi Restore from a file v Settings > Backups.

   • Alebo obnov pred prvým spustením. Daj zip s nezmeneným názvom do priečinka backups a skopíruj ho dnu cez docker cp backups holyarrs:/config/. Potom raz spusti obnovu s tým istým image:

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

     Ak máš cestu ku kľúču, pridaj -e HOLYARRS_MASTER_KEY_FILE=<its path>, aby obnova kontrolovala tvoj kľúč. restore --list ukáže názvy záloh, ktoré vidí.

4. Spusti HolyArrs. Mal by si vidieť svoju knižnicu a nastavenia späť.

Spustil si novú inštaláciu skôr, než si skopíroval kľúč? Ak na nej nie je nič, čo by stálo za uchovanie, zastav HolyArrs, prepíš nový kľúč starým rovnakým docker cp, obnov zálohu a potom spusti.

Ak to nefunguje

Príznak: „Backups are off in this build“. Príčina: táto kópia beží bez správcu záloh. Riešenie: v aplikácii žiadne; ovládanie záloh tu nie je.

Príznak: stiahnutie, vymazanie alebo obnova žiada heslo. Príčina: vyžadujú nedávne prihlásenie heslom. Riešenie: prihlás sa znova heslom a skús to ešte raz.

Príznak: obnova sa zamietne kvôli hlavnému kľúču. Príčina: kľúč v konfiguračnom priečinku nezodpovedá zálohe. Riešenie: vráť späť zodpovedajúci holyarrs.key a skús to znova.

Obnova zamietne aj zip, ktorý je príliš veľký alebo poškodený, obsahuje neočakávané súbory, pochádza z novšej verzie databázy alebo obsahuje dáta, ktoré tvoj kľúč nevie prečítať.

Pre expertov

Čo obsahuje záloha

Každá záloha je zip s hlavnou databázou, databázou udalostí (Events), ak existuje, a súborom backup.json (verzia HolyArrs, verzie databáz, druh zálohy, čas vytvorenia). Médiá, sťahovania, obrázky, logy a hlavný kľúč v nej nie sú.

Obnova pred prvým spustením

docker cp funguje pre pomenovaný volume aj priečinok na hostiteľovi; HolyArrs pri spustení odovzdá súbory v /config tvojmu PUID a PGID. Ak používaš HOLYARRS_MASTER_KEY_FILE, daj kľúč namiesto toho na túto cestu na hostiteľovi, čitateľný pre PUID a PGID.

1. Daj zip s nezmeneným názvom do priečinka backups a skopíruj ho dnu: docker cp backups holyarrs:/config/.
2. Raz spusti obnovu s tým istým image:
   • 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. Ak máš cestu ku kľúču, pridaj -e HOLYARRS_MASTER_KEY_FILE=<its path>, aby obnova kontrolovala tvoj kľúč.
4. Spusti HolyArrs.

restore --list ukáže názvy záloh, ktoré vidí.

Súvisiace stránky

• Aktualizácie
• Inštalácia
• Kontroly stavu