Backup

Geymdu afrit af uppsetningunni svo þú getir sett hana aftur upp eftir slæma uppfærslu, bilaðan disk eða flutning á nýja tölvu.

Áður en þú byrjar

• Settings > Backups (stillingar > backup) krefst heimildarinnar Change settings (breyta stillingum). Aðeins eigandinn endurheimtir.
• Til að sækja, eyða og endurheimta þarftu innskráningu með lykilorði frá síðustu mínútum.

Taktu backup

1. Opnaðu Settings > Backups.
2. Smelltu á Back up now (taka backup núna). Þú ættir að sjá nýja backup-ið undir Saved backups (vistuð backup).
3. Smelltu á Download (sækja) við hliðina á því til að geyma afrit utan tölvunnar sem keyrir HolyArrs.

Vistaðu aðallykilinn

Backup geyma aldrei aðallykilinn, sem opnar lykilorðin og API-lyklana í stillingunum þínum. Án samsvarandi lykils getur endurheimt backup ekki lesið þau.

1. Undir Master key (aðallykill) smellir eigandinn á Download key kit (sækja lyklapakka).
2. Geymdu skrána fjarri tölvunni sem keyrir HolyArrs og aðskilda frá backup-unum þínum. Þú ættir að sjá viðvörunina um lyklapakkann hverfa úr Settings > Backups og úr heilsuathugununum.

Til að nota hann seinna skaltu endurnefna hann í holyarrs.key og setja hann í stillingamöppuna. Ertu ekki eigandinn? Biddu eigandann að sækja hann.

Endurheimtu backup

Danger

Breytingar sem gerðar voru eftir backup-ið glatast. Hafðu samsvarandi aðallykil tilbúinn áður en þú byrjar.

1. Smelltu á Restore from a file (endurheimta úr skrá) og veldu zip-skrá með HolyArrs backup.
2. Staðfestu.
3. HolyArrs athugar skrána. Þú ættir að sjá Restore ready. It applies on the next start.
4. HolyArrs endurræsir sig og setur backup-ið á sinn stað. Með ráðlögðu endurræsingarstefnu Docker gerist þetta sjálfkrafa.

Núverandi gagnagrunnar þínir flytjast í /config/backups/before-restore-<time>, svo þú getur afturkallað endurheimtina.

Valkostir

Hversu oft

Valkostur	Tekur backup	Geymir
Balanced (jafnvægi, sjálfgefið)	Á hverjum degi	Síðustu 7 daga og 4 vikuleg afrit
Light (létt)	Einu sinni í viku	4 vikur. Minnst pláss
Careful (varkárt)	Á hverjum degi	Öll afrit í 30 daga

Nýjasta tímasetta backup-ið er alltaf geymt. Þessar reglur hreinsa aðeins tímasett backup. Backup sem þú býrð til standa þar til þú eyðir þeim (ruslatunnuhnappurinn á línunni; ekki er hægt að afturkalla það). HolyArrs tekur líka backup fyrir uppfærslu sem breytir vistuðum gögnum og geymir þrjú nýjustu; sjá Uppfærslur.

Flyttu á nýja tölvu

Ný uppsetning býr til sinn eigin aðallykil við fyrstu ræsingu. Sá lykill getur ekki opnað gömlu backup-in þín, svo endurheimtinni er hafnað. Settu gamla lykilinn á sinn stað fyrst. Dæmin kalla container-inn holyarrs; notaðu þitt eigið nafn.

1. Fyrir fyrstu ræsingu skaltu búa til container-inn án þess að ræsa hann: docker compose create, eða docker run línuna þína með docker create í stað docker run -d.
2. Afritaðu gamla lykilinn inn: docker cp holyarrs.key holyarrs:/config/. Lyklapakki endurnefndur í holyarrs.key virkar líka. Þetta virkar fyrir nefnt volume eða möppu á hýsli; HolyArrs afhendir skrárnar í /config til PUID og PGID þegar það ræsist. Ef þú notar HOLYARRS_MASTER_KEY_FILE skaltu setja lykilinn á þá slóð á hýslinum í staðinn, læsilegan fyrir PUID og PGID.
3. Endurheimtu backup-ið. Veldu eina leið:

   • Ræstu HolyArrs, kláraðu fyrstu ræsingu og notaðu svo Restore from a file í Settings > Backups.

   • Eða endurheimtu fyrir fyrstu ræsingu. Settu zip-skrána, með óbreyttu nafni, í möppu sem heitir backups og afritaðu hana inn með docker cp backups holyarrs:/config/. Keyrðu svo endurheimtina einu sinni með sömu 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>

     Með slóð að lyklaskrá skaltu bæta við -e HOLYARRS_MASTER_KEY_FILE=<its path> svo endurheimtin beri saman við lykilinn þinn. restore --list sýnir backup-nöfnin sem hún sér.

4. Ræstu HolyArrs. Þú ættir að sjá safnið þitt og stillingar aftur.

Ræstir þú nýju uppsetninguna áður en þú afritaðir lykilinn? Ef ekkert á henni er þess virði að geyma skaltu stöðva HolyArrs, afrita gamla lykilinn yfir þann nýja með sama docker cp, endurheimta og ræsa svo.

Ef það virkar ekki

Einkenni: „Backups are off in this build“. Orsök: þetta eintak keyrir án backup-stjórans. Lausn: engin í forritinu; það eru engar backup-stýringar.

Einkenni: Að sækja, eyða eða endurheimta biður um lykilorðið þitt. Orsök: þetta krefst nýlegrar innskráningar með lykilorði. Lausn: skráðu þig inn aftur með lykilorðinu og reyndu aftur.

Einkenni: endurheimtinni er hafnað vegna aðallykilsins. Orsök: lykillinn í stillingamöppunni passar ekki við backup-ið. Lausn: settu samsvarandi holyarrs.key aftur á sinn stað og reyndu aftur.

Endurheimtin hafnar líka zip-skrá sem er of stór eða skemmd, geymir óvæntar skrár, kemur úr nýrri útgáfu gagnagrunns eða geymir gögn sem lykillinn þinn getur ekki lesið.

Fyrir sérfræðinga

Hvað er í backup

Hvert backup er zip-skrá með aðalgagnagrunninum, Events-gagnagrunninum ef hann er til, og backup.json (útgáfa HolyArrs, útgáfur gagnagrunna, tegund backup, tími sem það var tekið). Margmiðlunarefni, niðurhal, myndir, logs og aðallykillinn eru ekki með.

Endurheimt fyrir fyrstu ræsingu

docker cp virkar fyrir nefnt volume eða möppu á hýsli; HolyArrs afhendir skrárnar í /config til PUID og PGID þegar það ræsist. Með HOLYARRS_MASTER_KEY_FILE skaltu setja lykilinn á þá slóð á hýslinum í staðinn, læsilegan fyrir PUID og PGID.

1. Settu zip-skrána, með óbreyttu nafni, í möppu sem heitir backups og afritaðu hana inn: docker cp backups holyarrs:/config/.
2. Keyrðu endurheimtina einu sinni með sömu 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. Með slóð að lyklaskrá skaltu bæta við -e HOLYARRS_MASTER_KEY_FILE=<its path> svo endurheimtin beri saman við lykilinn þinn.
4. Ræstu HolyArrs.

restore --list sýnir backup-nöfnin sem hún sér.

Tengt efni

• Uppfærslur
• Uppsetning
• Heilsuathuganir