Update

HolyArrs memberi tahu kamu kalau ada versi baru dan tidak pernah memasangnya sendiri. Kamu menarik image baru saat waktunya pas.

Lihat apakah ada versi baru

1. Buka halaman Status (http://your-server:6262/health).
2. Baca bagian Updates (update). Kamu akan melihat salah satu dari ini:

Pesan	Artinya
“HolyArrs 1.2.0 is out, newer than this one.”	Versi baru sudah keluar. Update kalau sudah siap
“This is the newest version.”	Tidak ada yang perlu dilakukan
“No HolyArrs release is published yet.”	Feed masih kosong. Tidak ada yang salah
“The last check did not work: …”	Feed tidak terjangkau, biasanya karena tidak ada internet
“The update check is off: …”	Dinonaktifkan di Pengaturan

3. Untuk memeriksa sekarang, klik Check now (periksa sekarang) atau Check again (periksa lagi). Kamu butuh izin Change settings (ubah pengaturan).

Versi yang lebih baru juga muncul sebagai peringatan kondisi. Pemeriksaan yang gagal hanya muncul di bawah Updates.

Update

1. Tarik image baru lalu restart: docker compose pull, lalu docker compose up -d.
2. HolyArrs mulai berjalan. Kalau versi baru mengubah cara data disimpan, HolyArrs membuat backup dulu, baru memperbarui datanya. Kamu akan melihat aplikasi terbuka di versi baru.

Tips

Langkah update yang gagal dibatalkan, dan HolyArrs berhenti di halaman yang menjelaskan apa yang terjadi. Data kamu dari sebelum update tetap ada sebagai backup.

Kembali ke versi sebelumnya

HolyArrs tidak bisa mengubah image-nya sendiri, jadi kamu menjalankan image yang lebih lama dan HolyArrs mengembalikan data yang lama.

Perhatian

Apa pun yang berubah setelah update, seperti judul baru, pengaturan dan riwayat, tidak ada di backup sebelum update.

1. Ubah image tag di file compose kamu (atau docker run) ke versi yang lebih lama, misalnya holyarrs/holyarrs:<older version>.
2. Jalankan docker compose up -d.
3. Kalau update tidak mengubah datanya, versi lama langsung berjalan. Selesai.
4. Kalau tidak, versi lama menampilkan sebuah halaman, bukan aplikasinya. Klik Put back the data from before the update (kembalikan data dari sebelum update).
5. Ketik kode sekali pakai. Temukan kodenya dengan docker logs <container>; cari tulisan “one-time code”.
6. HolyArrs memeriksa backup, memasangnya di tempatnya lalu berhenti. Kamu akan melihat container mulai lagi dengan data itu lewat kebijakan restart-nya. Kalau tidak ada kebijakan restart, mulai sendiri.

Tanpa halaman itu: docker exec <container> /holyarrs restore --pre-update, lalu docker restart <container>. Tanpa Docker: hentikan HolyArrs, jalankan holyarrs restore --pre-update, lalu mulai lagi.

Tidak ada yang dihapus. Data yang lebih baru dipindahkan ke backups/before-restore-<time>/, jadi kamu bisa membatalkannya. Kalau kembali lebih dari satu versi, HolyArrs memilih backup sebelum update terbaru yang bisa dibaca versi itu.

Pilihan

Semuanya ada di Settings > Health checks (Pengaturan > Pemeriksaan kondisi). Tiga yang terakhir ada di bagian lanjutan kartu itu.

Pengaturan	Bawaan	Ubah kalau
Check for a newer HolyArrs (periksa HolyArrs yang lebih baru)	Aktif	Kamu tidak mau ada permintaan keluar sama sekali
Check for updates every (periksa update setiap)	hari	Kamu mau lebih jarang memeriksa: 3, 7, 14 atau 30 hari
Release feed (feed rilis)	Kosong (rilis HolyArrs)	Kamu menjalankan feed sendiri
Feed may be on the local network (feed boleh ada di jaringan lokal)	Nonaktif	Feed kamu ada di jaringan sendiri
Include test versions (like 1.2.0-rc1) (sertakan versi uji coba)	Nonaktif	Kamu mau dapat pemberitahuan untuk versi uji coba

Kalau tidak berhasil

Gejala: “The last check did not work.” Penyebab: server tidak punya internet, atau feed kamu sendiri ada di jaringan lokal. Solusi: periksa akses internet, atau aktifkan Feed may be on the local network.

Gejala: feed rilis tidak mau disimpan. Penyebab: alamatnya berisi nama pengguna, kata sandi, ?query atau #fragment, atau tidak diawali http:// atau https://. Solusi: hapus bagian-bagian itu.

Gejala: update berhenti karena ruang disk kurang. Penyebab: tidak ada tempat untuk salinan dan update-nya. Solusi: kosongkan ruang di tempat folder konfigurasi berada, lalu mulai lagi.

Gejala: halaman kembali ke versi lama menolak kode kamu. Penyebab: kode lama, atau 10 kode salah sejak terakhir dimulai. Solusi: salin kode dari baris log terbaru. Setelah 10 kali salah, restart container dan pakai kode yang baru.

Fitur yang ditunda

Beberapa fitur nonaktif secara bawaan di versi ini. Aktifkan dengan risiko kamu sendiri. Selama ditunda, halaman dan item menunya disembunyikan, route API-nya menjawab “not found”, dan tugasnya tidak berjalan. Data yang sudah kamu simpan untuk fitur itu tetap ada.

Untuk mengaktifkan satu fitur, tambahkan sakelarnya ke HOLYARRS_FLAGS, dipisah koma, lalu restart container:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Hapus namanya lalu restart untuk menonaktifkannya. Pengaturan yang tersembunyi kembali saat kamu mengaktifkannya lagi.

Sakelar	Fitur
row_title_stats	Statistik judul pada baris Jelajahi di Appearance
trakt_lists	Kunci Trakt, daftar Trakt dan ulasan Trakt. Daftar TMDB tetap aktif
alert_channels_more	Notifikasi Telegram, ntfy, Gotify, Pushover dan webhook. Discord dan email tetap aktif
subtitle_sites	Situs subtitle dan pencarian subtitle. Bahasa subtitle kamu tetap aktif
emby_signin	Login dengan Emby. Penyegaran pustaka Emby tetap berfungsi
go_back	Panel Go back (kembali ke versi sebelumnya) di halaman Status. Langkah-langkah di Kembali berfungsi tanpanya

Tidak ada yang berubah setelah menambahkan sakelar? Periksa ejaannya (huruf kecil, garis bawah) dan restart container, bukan hanya halamannya.

Untuk yang mahir

Apa yang dikirim pemeriksaan

Satu permintaan ke api.github.com untuk rilis terbaru, hanya dengan User-Agent: HolyArrs/<version>. Tanpa akun, kunci atau daftar media. Kalau pemeriksaan dinonaktifkan, tidak ada permintaan sama sekali.

Jawaban terakhir disimpan, jadi restart tidak memeriksa sebelum waktunya. Satu pemeriksaan menunggu paling lama 15 detik, membaca paling banyak 512 KB dan mengikuti paling banyak 3 redirect, tanpa pernah berpindah antara http dan https. Tautan catatan rilis hanya muncul kalau mengarah ke halaman rilis HolyArrs di GitHub; kalau tidak, versinya tampil sebagai teks biasa.

Release feed menerima jawaban rilis bergaya GitHub, daftar rilis, JSON apa pun yang berisi version, atau teks biasa yang berisi versinya. Alamat metadata cloud selalu ditolak. Versi uji coba dianggap lebih lama daripada versi biasanya.

Backup sebelum update

Sebelum mengubah data yang tersimpan, HolyArrs:

1. Memeriksa ada ruang untuk salinan dan update-nya. Kalau tidak ada, tidak ada yang berubah. Lewati dengan HOLYARRS_SKIP_SPACE_CHECK=yes.
2. Menyalin setiap database ke backups, memeriksa salinannya dan menulis file sha256 di sebelahnya. Setelah 3 kali gagal menyalin, tidak ada yang berubah.
3. Menjalankan tiap langkah update sendiri-sendiri dan memeriksanya. Langkah yang gagal dibatalkan; langkah yang sudah selesai tetap. Mulai versi yang sama lagi untuk melanjutkan dari langkah yang gagal dengan salinan yang sama.

Setelah HolyArrs berhasil dimulai pertama kali, salinan itu menjadi holyarrs-backup-pre-update-<time>.zip, dengan deskripsi seperti “before updating from 1.1.0 to 1.2.0”. Backup ini muncul di Settings > Backups dan holyarrs restore --list. 3 yang terbaru disimpan; jadwal backup tidak pernah menghapusnya. Pemasangan baru atau update yang tidak menyentuh data tidak membuat backup.

Verifikasi image

Mulai dari 1.0.3, setiap image di Docker Hub ditandatangani oleh proses rilis di GitHub. Tidak ada kunci yang perlu diunduh. Periksa image dengan cosign. Masukkan versi yang kamu jalankan, seperti 1.0.3, di tempat tertulis <version>:

cosign verify holyarrs/holyarrs:<version> \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --certificate-identity-regexp '^https://github.com/HolyArrs/HolyArrs/\.github/workflows/sign\.yml@refs/(tags/[0-9.]+|heads/main)$'

Kamu akan melihat The cosign claims were validated. Hasil lain berarti image itu tidak berasal dari proses rilis HolyArrs: jangan dijalankan.

Image ini juga membawa catatan cara pembuatannya dan daftar isinya (SBOM). Periksa dengan GitHub CLI:

gh attestation verify oci://docker.io/holyarrs/holyarrs:<version> --repo HolyArrs/HolyArrs

File yang sama ada di setiap rilis GitHub: .sigstore.json (tanda tangan), .intoto.jsonl (catatan build) dan .sbom.spdx.json (isi).

Terkait

• Backup
• Pemeriksaan kondisi
• Bagian dan mode aman