Backupok

Tarts egy másolatot a beállításaidról, hogy rossz frissítés, elromlott lemez vagy új gépre költözés után visszatehesd.

Mielőtt elkezdenéd

• A Settings > Backups (Beállítások > Backupok) oldalhoz kell a Change settings (beállítások módosítása) jogosultság. Visszaállítani csak a tulajdonos tud.
• A letöltéshez, törléshez és visszaállításhoz néhány perccel korábbi, jelszavas bejelentkezés kell.

Backup készítése

1. Nyisd meg a Settings > Backups oldalt.
2. Kattints a Back up now (backup most) gombra. Az új backupot a Saved backups (mentett backupok) alatt kell látnod.
3. Kattints mellette a Download (letöltés) gombra, hogy legyen egy másolatod a szerveren kívül is.

A főkulcs mentése

A backupok sosem tartalmazzák a főkulcsot, ami a beállításaidban lévő jelszavakat és API-kulcsokat nyitja. A megfelelő kulcs nélkül a visszaállított backup nem tudja elolvasni őket.

1. A Master key (főkulcs) alatt a tulajdonos a Download key kit (kulcscsomag letöltése) gombra kattint.
2. Tartsd a fájlt a szerveren kívül, a backupoktól külön. Ezután a kulcscsomag figyelmeztetésének el kell tűnnie a Settings > Backups oldalról és az állapotellenőrzésekből.

Ha később használni akarod, nevezd át holyarrs.key névre, és tedd a konfigurációs mappába. Nem te vagy a tulajdonos? Kérd meg a tulajdonost, hogy töltse le.

Backup visszaállítása

Veszély

A backup óta történt módosítások elvesznek. Előtte készítsd elő a hozzá tartozó főkulcsot.

1. Kattints a Restore from a file (visszaállítás fájlból) gombra, és válassz ki egy HolyArrs backup zipet.
2. Erősítsd meg.
3. A HolyArrs ellenőrzi a fájlt. Ezt kell látnod: Restore ready. It applies on the next start.
4. A HolyArrs újraindul, és a helyére teszi a backupot. Az ajánlott Docker újraindítási szabállyal ez magától megtörténik.

A jelenlegi adatbázisaid a /config/backups/before-restore-<time> mappába kerülnek, így vissza tudod vonni a visszaállítást.

Lehetőségek

Milyen gyakran

Lehetőség	Mikor készül backup	Meddig marad meg
Balanced (kiegyensúlyozott, alapértelmezett)	Minden nap	Az utolsó 7 nap és 4 heti másolat
Light (könnyű)	Hetente egyszer	4 hét. A legkevesebb helyet foglalja
Careful (óvatos)	Minden nap	Minden másolat 30 napig

A legújabb ütemezett backup mindig megmarad. Ezek a szabályok csak az ütemezett backupokat takarítják. A kézzel készített backupok addig maradnak, amíg nem törlöd őket (a sor végén lévő kuka gombbal; ezt nem lehet visszavonni). A HolyArrs backupot készít az olyan frissítés előtt is, amely módosítja a tárolt adatokat, és a legutóbbi 3-at megtartja; lásd: Frissítések.

Költözés új gépre

Az új telepítés az első indításkor saját főkulcsot készít. Ez a kulcs nem nyitja a régi backupjaidat, ezért a rendszer elutasítja a visszaállítást. Előbb told a helyére a régi kulcsot. A példákban a container neve holyarrs; használd a sajátodat.

1. Az első indítás előtt hozd létre a containert indítás nélkül: docker compose create, vagy a docker run soroddal, docker run -d helyett docker create paranccsal.
2. Másold be a régi kulcsodat: docker cp holyarrs.key holyarrs:/config/. A holyarrs.key névre átnevezett kulcscsomag is jó. Ez működik névvel ellátott volume-mal és gazdagép-mappával is; a HolyArrs induláskor a /config fájljait átadja a PUID és PGID értékednek. Ha a HOLYARRS_MASTER_KEY_FILE változót használod, a kulcsot a gépen ezen az útvonalon tartsd, a PUID és PGID által olvashatóan.
3. Állítsd vissza a backupot. Válassz egy módot:

   • Indítsd el a HolyArrsot, fejezd be az első indítás lépéseit, majd használd a Restore from a file gombot a Settings > Backups oldalon.

   • Vagy állítsd vissza az első indítás előtt. Tedd a zipet változatlan névvel egy backups nevű mappába, és másold be: docker cp backups holyarrs:/config/. Ezután futtasd egyszer a visszaállítást ugyanazzal az image-dzsel:

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

     Kulcsfájl útvonala esetén add hozzá: -e HOLYARRS_MASTER_KEY_FILE=<its path>, hogy a visszaállítás a te kulcsoddal ellenőrizzen. A restore --list megmutatja a látható backupok neveit.

4. Indítsd el a HolyArrsot. A médiatáradnak és a beállításaidnak vissza kell jönnie.

Elindítottad az új telepítést, mielőtt bemásoltad a kulcsot? Ha nincs rajta semmi megtartandó, állítsd le a HolyArrsot, másold a régi kulcsodat az újra ugyanazzal a docker cp paranccsal, állítsd vissza a backupot, aztán indítsd el.

Ha nem működik

Tünet: „Backups are off in this build”. Ok: ez a példány a backupkezelője nélkül fut. Megoldás: az appban nincs rá megoldás; nincsenek backupvezérlők.

Tünet: a letöltés, törlés vagy visszaállítás elkéri a jelszavadat. Ok: ezekhez friss, jelszavas bejelentkezés kell. Megoldás: jelentkezz be újra a jelszavaddal, és próbáld újra.

Tünet: a visszaállítást a főkulcs miatt elutasítja. Ok: a konfigurációs mappában lévő kulcs nem egyezik a backuppal. Megoldás: told vissza a megfelelő holyarrs.key fájlt, és próbáld újra.

A visszaállítás azt a zipet is elutasítja, amely túl nagy vagy sérült, váratlan fájlokat tartalmaz, újabb adatbázis-verzióból származik, vagy olyan adatot tartalmaz, amit a kulcsod nem tud elolvasni.

Haladóknak

Mi van egy backupban

Minden backup egy zip a fő adatbázissal, az Események adatbázisával (ha van), és egy backup.json fájllal (HolyArrs-verzió, adatbázis-verziók, a backup fajtája, a készítés ideje). A média, a letöltések, a borítóképek, a logok és a főkulcs nincsenek benne.

Visszaállítás az első indítás előtt

A docker cp névvel ellátott volume-mal és gazdagép-mappával is működik; a HolyArrs induláskor a /config fájljait átadja a PUID és PGID értékednek. A HOLYARRS_MASTER_KEY_FILE esetén a kulcsot ezen a gépen lévő útvonalon tartsd, a PUID és PGID által olvashatóan.

1. Tedd a zipet változatlan névvel egy backups nevű mappába, és másold be: docker cp backups holyarrs:/config/.
2. Futtasd egyszer a visszaállítást ugyanazzal az image-dzsel:
   • 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. Kulcsfájl útvonala esetén add hozzá: -e HOLYARRS_MASTER_KEY_FILE=<its path>, hogy a visszaállítás a te kulcsoddal ellenőrizzen.
4. Indítsd el a HolyArrsot.

A restore --list megmutatja a látható backupok neveit.

Kapcsolódó oldalak

• Frissítések
• Telepítés
• Állapotellenőrzések