Backup

Simpan salinan pengaturan kamu untuk dikembalikan setelah update yang bermasalah, disk yang rusak, atau pindah ke komputer baru.

Sebelum mulai

• Settings > Backups (pengaturan > backup) butuh izin Change settings (mengubah pengaturan). Hanya pemilik yang boleh memulihkan.
• Unduh, hapus, dan pulihkan butuh login dengan kata sandi dalam beberapa menit terakhir.

Buat backup

1. Buka Settings > Backups.
2. Klik Back up now (backup sekarang). Kamu akan melihat backup baru di bawah Saved backups (backup tersimpan).
3. Klik Download (unduh) di sebelahnya untuk menyimpan salinan di luar server.

Simpan kunci utama

Backup tidak pernah berisi kunci utama, yaitu kunci yang membuka kata sandi dan kunci API di pengaturan kamu. Tanpa kunci yang cocok, backup yang dipulihkan tidak bisa membaca semuanya.

1. Di bawah Master key (kunci utama), pemilik klik Download key kit (unduh paket kunci).
2. Simpan file itu jauh dari server dan terpisah dari backup kamu. Kamu akan melihat peringatan key kit hilang dari Settings > Backups dan dari pemeriksaan kondisi.

Untuk memakainya nanti, ganti namanya menjadi holyarrs.key lalu taruh di folder konfigurasi. Bukan pemilik? Minta pemilik untuk mengunduhnya.

Pulihkan backup

Bahaya

Perubahan yang dibuat setelah backup akan hilang. Siapkan dulu kunci utama yang cocok.

1. Klik Restore from a file (pulihkan dari file) lalu pilih file zip backup HolyArrs.
2. Konfirmasi.
3. HolyArrs memeriksa file itu. Kamu akan melihat Restore ready. It applies on the next start.
4. HolyArrs memulai ulang dan memasang backup. Dengan kebijakan restart Docker yang disarankan, ini terjadi dengan sendirinya.

Database kamu yang sekarang dipindahkan ke /config/backups/before-restore-<time>, jadi kamu bisa membatalkan pemulihan.

Pilihan

Seberapa sering

Pilihan	Membuat backup	Menyimpan
Balanced (seimbang, bawaan)	Setiap hari	7 hari terakhir dan 4 salinan mingguan
Light (ringan)	Seminggu sekali	4 minggu. Paling hemat ruang
Careful (hati-hati)	Setiap hari	Semua salinan selama 30 hari

Backup terjadwal yang terbaru selalu disimpan. Aturan ini hanya membersihkan backup terjadwal. Backup yang kamu buat sendiri tetap ada sampai kamu menghapusnya (tombol tempat sampah di barisnya; tidak bisa dibatalkan). HolyArrs juga membuat backup sebelum update yang mengubah data tersimpan dan menyimpan 3 yang terbaru; lihat Update.

Pindah ke komputer baru

Pemasangan baru membuat kunci utamanya sendiri saat pertama kali dijalankan. Kunci itu tidak bisa membuka backup lama kamu, jadi pemulihan ditolak. Taruh dulu kunci yang lama. Contoh di bawah menamai container holyarrs; pakai nama kamu sendiri.

1. Sebelum dijalankan pertama kali, buat container tanpa memulainya: docker compose create, atau baris docker run kamu dengan docker create sebagai ganti docker run -d.
2. Salin kunci lama kamu ke dalam: docker cp holyarrs.key holyarrs:/config/. Key kit yang namanya diganti menjadi holyarrs.key juga bisa. Ini berlaku untuk volume bernama maupun folder host; HolyArrs menyerahkan file di /config ke PUID dan PGID kamu saat dimulai. Kalau kamu memakai HOLYARRS_MASTER_KEY_FILE, taruh kunci di path itu di host, dan pastikan bisa dibaca oleh PUID dan PGID kamu.
3. Pulihkan backup. Pilih salah satu cara:

   • Mulai HolyArrs, selesaikan pertama kali dijalankan, lalu pakai Restore from a file di Settings > Backups.

   • Atau pulihkan sebelum dijalankan pertama kali. Taruh file zip, dengan nama tidak diubah, di folder bernama backups lalu salin ke dalam dengan docker cp backups holyarrs:/config/. Setelah itu jalankan pemulihan sekali dengan image yang sama:

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

     Kalau kamu memakai path file kunci, tambahkan -e HOLYARRS_MASTER_KEY_FILE=<its path> supaya pemulihan memeriksa dengan kunci kamu. restore --list menampilkan nama backup yang bisa dilihatnya.

4. Mulai HolyArrs. Kamu akan melihat pustaka dan pengaturan kamu kembali.

Sudah memulai pemasangan baru sebelum menyalin kunci? Kalau tidak ada yang perlu disimpan di dalamnya, hentikan HolyArrs, salin kunci lama kamu menimpa yang baru dengan docker cp yang sama, pulihkan, lalu mulai.

Kalau tidak berhasil

Gejala: “Backups are off in this build”. Penyebab: salinan ini berjalan tanpa pengelola backup. Solusi: tidak ada di aplikasi; tidak ada kontrol backup.

Gejala: unduh, hapus, atau pulihkan meminta kata sandi kamu. Penyebab: semuanya butuh login dengan kata sandi yang baru. Solusi: masuk lagi dengan kata sandi kamu lalu coba lagi.

Gejala: pemulihan ditolak karena kunci utama. Penyebab: kunci di folder konfigurasi tidak cocok dengan backup. Solusi: kembalikan holyarrs.key yang cocok lalu coba lagi.

Pemulihan juga menolak file zip yang terlalu besar atau rusak, berisi file tak terduga, berasal dari versi database yang lebih baru, atau berisi data yang tidak bisa dibaca kunci kamu.

Untuk yang mahir

Isi sebuah backup

Setiap backup adalah file zip berisi database utama, database Events kalau ada, dan backup.json (versi HolyArrs, versi database, jenis backup, waktu dibuat). Media, unduhan, artwork, log, dan kunci utama tidak termasuk.

Pulihkan sebelum dijalankan pertama kali

docker cp berlaku untuk volume bernama maupun folder host; HolyArrs menyerahkan file di /config ke PUID dan PGID kamu saat dimulai. Kalau memakai HOLYARRS_MASTER_KEY_FILE, taruh kunci di path host itu, dan pastikan bisa dibaca oleh PUID dan PGID.

1. Taruh file zip, dengan nama tidak diubah, di folder bernama backups lalu salin ke dalam: docker cp backups holyarrs:/config/.
2. Jalankan pemulihan sekali dengan image yang sama:
   • 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. Kalau memakai path file kunci, tambahkan -e HOLYARRS_MASTER_KEY_FILE=<its path> supaya pemulihan memeriksa dengan kunci kamu.
4. Mulai HolyArrs.

restore --list menampilkan nama backup yang bisa dilihatnya.

Terkait

• Update
• Pemasangan
• Pemeriksaan kondisi