Mga backup

Magtabi ng kopya ng setup mo para maibalik pagkatapos ng masamang update, sirang disk o paglipat sa bagong computer.

Bago ka magsimula

• Kailangan ng Settings > Backups ang permiso na Change settings (baguhin ang mga setting). Ang may-ari lang ang nagre-restore.
• Ang pag-download, pagbura at pag-restore ay nangangailangan ng password sign-in sa nakalipas na ilang minuto.

Gumawa ng backup

1. Buksan ang Settings > Backups.
2. Pindutin ang Back up now (mag-backup ngayon). Dapat makita mo ang bagong backup sa ilalim ng Saved backups (mga naka-save na backup).
3. Pindutin ang Download (i-download) sa tabi nito para magtabi ng kopya sa labas ng server.

I-save ang master key

Hindi kailanman kasama sa mga backup ang master key, na nagbubukas ng mga password at API key sa mga setting mo. Kung wala ang katugmang key, hindi mababasa ng na-restore na backup ang mga iyon.

1. Sa ilalim ng Master key, pinipindot ng may-ari ang Download key kit (i-download ang key kit).
2. Itago ang file na malayo sa server at hiwalay sa mga backup mo. Dapat makita mo na nawawala ang babala ng key kit sa Settings > Backups at sa mga pagsusuri ng kalusugan.

Para magamit ito sa susunod, palitan ang pangalan nito ng holyarrs.key at ilagay sa config folder. Hindi ka ang may-ari? Hilingin sa may-ari na i-download ito.

Mag-restore ng backup

Danger

Mawawala ang mga pagbabagong ginawa mula nang kunin ang backup. Ihanda muna ang katugmang master key.

1. Pindutin ang Restore from a file (mag-restore mula sa file) at pumili ng backup zip ng HolyArrs.
2. Kumpirmahin.
3. Susuriin ng HolyArrs ang file. Dapat makita mo ang Restore ready. It applies on the next start.
4. Magre-restart ang HolyArrs at ilalagay ang backup. Kapag ginamit mo ang inirerekomendang restart policy ng Docker, kusa itong mangyayari.

Ililipat ang kasalukuyan mong mga database sa /config/backups/before-restore-<time>, kaya puwede mong i-undo ang restore.

Mga pagpipilian

Gaano kadalas

Pagpipilian	Nagba-backup	Itinatago
Balanced (default)	Araw-araw	Huling 7 araw at 4 na lingguhang kopya
Light	Minsan sa isang linggo	4 na linggo. Pinakamaliit na espasyo
Careful	Araw-araw	Bawat kopya sa loob ng 30 araw

Palaging itinatago ang pinakabagong naka-iskedyul na backup. Mga naka-iskedyul na backup lang ang nililinis ng mga patakarang ito. Ang mga backup na ikaw mismo ang gumawa ay mananatili hanggang burahin mo (trash button sa row; hindi na ito mababawi). Nagba-backup din ang HolyArrs bago ang update na nagbabago ng naka-store na data at itinatago ang pinakabagong 3; tingnan ang Mga update.

Lumipat sa bagong computer

Gumagawa ang bagong install ng sarili nitong master key sa unang takbo. Hindi mabubuksan ng key na iyon ang mga lumang backup mo, kaya tinatanggihan ang restore. Ilagay muna ang lumang key. Tinatawag na holyarrs ang container sa mga halimbawa; gamitin ang sarili mong pangalan.

1. Bago ang unang takbo, gawin ang container nang hindi sinisimulan: docker compose create, o ang docker run line mo na may docker create sa halip na docker run -d.
2. Kopyahin doon ang lumang key mo: docker cp holyarrs.key holyarrs:/config/. Gumagana rin ang key kit na pinalitan ng pangalan bilang holyarrs.key. Gumagana ito para sa named volume o host folder; ibibigay ng HolyArrs ang mga file sa /config sa PUID at PGID mo pagsimula nito. Kung gamit mo ang HOLYARRS_MASTER_KEY_FILE, ilagay na lang ang key sa path na iyon sa host, na mababasa ng PUID at PGID mo.
3. I-restore ang backup. Pumili ng isang paraan:

   • Simulan ang HolyArrs, tapusin ang unang takbo, at gamitin ang Restore from a file sa Settings > Backups.

   • O mag-restore bago ang unang takbo. Ilagay ang zip, hindi binago ang pangalan, sa folder na tinatawag na backups at kopyahin ito gamit ang docker cp backups holyarrs:/config/. Pagkatapos ay patakbuhin nang isang beses ang restore gamit ang parehong 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>

     Kung may path ng key file, idagdag ang -e HOLYARRS_MASTER_KEY_FILE=<its path> para masuri ng restore laban sa key mo. Ipinapakita ng restore --list ang mga pangalan ng backup na nakikita nito.

4. Simulan ang HolyArrs. Dapat makita mo ang Aklatan at mga setting mo na bumalik.

Sinimulan mo ang bagong install bago kopyahin ang key? Kung walang mahalaga rito, ihinto ang HolyArrs, kopyahin ang lumang key mo sa ibabaw ng bago gamit ang parehong docker cp, mag-restore, at saka simulan.

Kung hindi gumana

Sintomas: “Backups are off in this build”. Dahilan: tumatakbo ang kopyang ito nang walang backup manager. Solusyon: walang magagawa sa app; walang mga kontrol sa backup.

Sintomas: humihingi ng password ang pag-download, pagbura o pag-restore. Dahilan: nangangailangan ang mga ito ng kamakailang password sign-in. Solusyon: mag-sign in ulit gamit ang password mo at subukan ulit.

Sintomas: tinanggihan ang restore dahil sa master key. Dahilan: hindi tugma ang key sa config folder sa backup. Solusyon: ibalik ang katugmang holyarrs.key at subukan ulit.

Tinatanggihan din ng restore ang zip na masyadong malaki o sira, may hindi inaasahang file, galing sa mas bagong bersyon ng database, o may data na hindi mabasa ng key mo.

Para sa mga eksperto

Ano ang laman ng backup

Ang bawat backup ay isang zip na may pangunahing database, ang Events database kung meron, at backup.json (bersyon ng HolyArrs, bersyon ng mga database, uri ng backup, oras ng paggawa). Wala rito ang media, mga download, artwork, mga log at master key.

Mag-restore bago ang unang takbo

Gumagana ang docker cp para sa named volume o host folder; ibibigay ng HolyArrs ang mga file sa /config sa PUID at PGID mo pagsimula nito. Kung gamit ang HOLYARRS_MASTER_KEY_FILE, ilagay na lang ang key sa host path na iyon, na mababasa ng PUID at PGID.

1. Ilagay ang zip, hindi binago ang pangalan, sa folder na tinatawag na backups at kopyahin ito: docker cp backups holyarrs:/config/.
2. Patakbuhin nang isang beses ang restore gamit ang parehong 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. Kung may path ng key file, idagdag ang -e HOLYARRS_MASTER_KEY_FILE=<its path> para masuri ng restore laban sa key mo.
4. Simulan ang HolyArrs.

Ipinapakita ng restore --list ang mga pangalan ng backup na nakikita nito.

Kaugnay

• Mga update
• I-install
• Mga pagsusuri ng kalusugan