Zálohy

Měj po ruce kopii svého nastavení, abys ho mohl vrátit zpět po nepovedené aktualizaci, rozbitém disku nebo při přechodu na nový počítač.

Než začneš

• Settings > Backups (Nastavení > Zálohy) vyžaduje oprávnění Change settings (měnit nastavení). Obnovit data smí jen vlastník.
• Stažení, smazání a obnova vyžadují přihlášení heslem v posledních několika minutách.

Vytvoř zálohu

1. Otevři Settings > Backups.
2. Klikni na Back up now (zálohovat hned). Novou zálohu uvidíš pod Saved backups (uložené zálohy).
3. Klikni vedle ní na Download (stáhnout), ať máš kopii mimo server.

Uschovej hlavní klíč

Zálohy nikdy neobsahují hlavní klíč, který odemyká hesla a API klíče v tvém nastavení. Bez odpovídajícího klíče je obnovená záloha nepřečte.

1. Pod Master key (hlavní klíč) vlastník klikne na Download key kit (stáhnout sadu s klíčem).
2. Uschovej soubor mimo server a zvlášť od záloh. Varování ohledně sady s klíčem by pak mělo zmizet ze Settings > Backups i z kontrol zdraví.

Až ho budeš potřebovat, přejmenuj ho na holyarrs.key a dej ho do konfigurační složky. Nejsi vlastník? Požádej vlastníka, ať ho stáhne.

Obnov zálohu

Nebezpečí

Změny provedené po vytvoření zálohy se ztratí. Nejdřív si připrav odpovídající hlavní klíč.

1. Klikni na Restore from a file (obnovit ze souboru) a vyber zip se zálohou HolyArrs.
2. Potvrď.
3. HolyArrs soubor zkontroluje. Měl bys vidět Restore ready. It applies on the next start.
4. HolyArrs se restartuje a zálohu nasadí. S doporučenou zásadou restartu v Dockeru se to stane samo.

Tvoje současné databáze se přesunou do /config/backups/before-restore-<time>, takže obnovu můžeš vzít zpět.

Možnosti

Jak často

Možnost	Zálohuje	Uchovává
Balanced (vyvážená; výchozí)	Každý den	Posledních 7 dní a 4 týdenní kopie
Light (lehká)	Jednou týdně	4 týdny. Nejméně místa
Careful (pečlivá)	Každý den	Všechny kopie po 30 dní

Nejnovější plánovaná záloha se uchová vždy. Tato pravidla čistí jen plánované zálohy. Zálohy, které vytvoříš sám, zůstanou, dokud je nesmažeš (tlačítko koše na řádku; nejde to vrátit). HolyArrs zálohuje také před aktualizací, která mění uložená data, a uchovává poslední 3; viz Aktualizace.

Přechod na nový počítač

Nová instalace si při prvním spuštění vytvoří vlastní hlavní klíč. Ten staré zálohy neotevře, takže obnova se odmítne. Nejdřív proto nasaď starý klíč. V příkladech se kontejner jmenuje holyarrs; použij svůj název.

1. Před prvním spuštěním kontejner vytvoř, ale nespouštěj: docker compose create, nebo svůj řádek docker run s docker create místo docker run -d.
2. Zkopíruj dovnitř starý klíč: docker cp holyarrs.key holyarrs:/config/. Funguje i sada s klíčem přejmenovaná na holyarrs.key. Platí to pro pojmenovaný volume i složku na hostiteli; HolyArrs při startu předá soubory v /config tvému PUID a PGID. Pokud používáš HOLYARRS_MASTER_KEY_FILE, dej klíč na hostiteli na tuto cestu, čitelný pro tvůj PUID a PGID.
3. Obnov zálohu. Vyber jednu cestu:

   • Spusť HolyArrs, dokonči první spuštění a pak použij Restore from a file v Settings > Backups.

   • Nebo obnov před prvním spuštěním. Dej zip beze změny názvu do složky backups a zkopíruj ji dovnitř přes docker cp backups holyarrs:/config/. Pak spusť obnovu jednou se stejný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>

     Pokud máš cestu k souboru s klíčem, přidej -e HOLYARRS_MASTER_KEY_FILE=<its path>, aby obnova kontrolovala proti tvému klíči. restore --list ukáže názvy záloh, které vidí.

4. Spusť HolyArrs. Měl bys vidět svou knihovnu a nastavení zpátky.

Spustil jsi novou instalaci dřív, než jsi zkopíroval klíč? Pokud na ní nic nestojí za zachování, zastav HolyArrs, přepiš nový klíč starým stejným docker cp, obnov zálohu a pak spusť.

Když to nefunguje

Příznak: „Backups are off in this build“. Příčina: tato kopie běží bez správce záloh. Řešení: v aplikaci žádné; nejsou tu žádné ovládací prvky záloh.

Příznak: stažení, smazání nebo obnova se ptá na heslo. Příčina: vyžadují nedávné přihlášení heslem. Řešení: přihlas se znovu heslem a zkus to znovu.

Příznak: obnova je odmítnuta kvůli hlavnímu klíči. Příčina: klíč v konfigurační složce neodpovídá záloze. Řešení: vrať zpět odpovídající holyarrs.key a zkus to znovu.

Obnova odmítne také zip, který je příliš velký nebo poškozený, obsahuje neočekávané soubory, pochází z novější verze databáze nebo obsahuje data, která tvůj klíč nepřečte.

Pro pokročilé

Co je v záloze

Každá záloha je zip s hlavní databází, databází Events, pokud existuje, a souborem backup.json (verze HolyArrs, verze databází, druh zálohy, čas vytvoření). Média, stahování, obrázky, logy a hlavní klíč v ní nejsou.

Obnova před prvním spuštěním

docker cp funguje pro pojmenovaný volume i složku na hostiteli; HolyArrs při startu předá soubory v /config tvému PUID a PGID. S HOLYARRS_MASTER_KEY_FILE dej klíč na tuto cestu na hostiteli, čitelný pro PUID a PGID.

1. Dej zip beze změny názvu do složky backups a zkopíruj ji dovnitř: docker cp backups holyarrs:/config/.
2. Spusť obnovu jednou se stejný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. Pokud máš cestu k souboru s klíčem, přidej -e HOLYARRS_MASTER_KEY_FILE=<its path>, aby obnova kontrolovala proti tvému klíči.
4. Spusť HolyArrs.

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

Související

• Aktualizace
• Instalace
• Kontroly zdraví