Bagian dan mode aman

Nonaktifkan bagian yang tidak kamu pakai, mulai dalam mode aman kalau ada yang rusak, dan mulai ulang HolyArrs dari browser.

Aktifkan atau nonaktifkan sebuah bagian

HolyArrs punya 5 bagian: Movies (film), TV shows (serial), Music (musik), Subtitles (subtitle) dan Requests (permintaan). Kamu memilihnya pertama kali di wizard pertama kali dijalankan.

1. Buka Settings > Parts (pengaturan > bagian).
2. Klik Turn on (aktifkan) atau Turn off (nonaktifkan) di sebelah sebuah bagian. Kamu akan melihat item menunya muncul atau hilang.

Tidak ada yang dihapus. Aktifkan lagi bagiannya dan semuanya lanjut dari tempat terakhir.

Mulai dalam mode aman

Mode aman hanya menjalankan hal-hal dasar, untuk saat sesuatu menghalangi HolyArrs mulai atau bekerja. Kamu tetap bisa masuk, melihat pustaka, mengubah pengaturan, dan membuat atau memulihkan backup. Pencarian, penambahan, penyegaran, pengunduhan, dan impor menunggu sampai HolyArrs dimulai normal lagi.

1. Buka Settings > Danger zone (pengaturan > zona bahaya).
2. Klik Restart in safe mode (mulai ulang dalam mode aman). Kamu akan melihat spanduk di setiap halaman.
3. Perbaiki masalahnya, lalu klik Restart HolyArrs (mulai ulang HolyArrs). Setelah itu HolyArrs dimulai seperti biasa.

Kalau halamannya tidak bisa dijangkau, setel HOLYARRS_SAFE_MODE=1 di Compose atau mulai dengan -safe-mode. Hapus setelah masalah beres: keduanya membuat HolyArrs selalu dimulai dalam mode aman.

Pilihan

Apa yang berhenti saat sebuah bagian nonaktif

Bagian	Berhenti	Tetap jalan
Film	Halaman dan item menu film, penambahan, pencarian, penyegaran	Unduhan yang sudah ada di downloader kamu tetap diikuti. File tetap ada.
Serial	Halaman serial, penambahan, pencarian, pencarian musim, penyegaran	Sama seperti Film.
Musik	Halaman artis dan album, pengaturan musik, penyegaran artis, pencarian album	Sama seperti Film.
Subtitle	Pengaturan subtitle, halaman subtitle yang hilang, pencarian dan pemeriksaan	File subtitle di samping video kamu tetap ada.
Permintaan	Halaman permintaan dan permintaan judul	Permintaan yang sudah ada tetap ada dan kembali saat bagiannya diaktifkan lagi.

Selalu aktif: login dan akun, folder pustaka, sumber, downloader dan unduhan, notifikasi, riwayat, backup, pemeriksaan kondisi, pengaturan, dan API.

• Subtitle butuh Film atau Serial. Permintaan butuh Film, Serial, atau Musik. HolyArrs menolak perubahan yang melanggar ini dan menyebutkan apa yang harus diubah dulu.
• Tugas dalam antrean untuk bagian yang nonaktif menunggu dan berjalan begitu bagiannya diaktifkan.
• Menonaktifkan sebuah bagian tidak menghemat memori. Semuanya berjalan dalam satu program.

Mulai ulang, jeda, dan matikan

Settings > Danger zone (pemilik dan admin) punya Restart HolyArrs, Restart in safe mode dan Shut down (matikan), serta Pause (jeda), Resume (lanjutkan) dan Restart untuk setiap tugas latar belakang, seperti backup atau sinkronisasi unduhan.

• Kontrol yang menghentikan sesuatu meminta konfirmasi dalam 60 detik.
• Setiap kontrol yang dipakai ditulis ke Riwayat beserta nama kamu.
• Kamu butuh login dengan kata sandi. Login tanpa kata sandi di jaringan lokal kamu ditolak.

Mulai ulang menghentikan HolyArrs dengan rapi dan membiarkan Docker memulainya lagi, jadi setel restart: unless-stopped.

Kebijakan restart	Mulai ulang	Matikan
unless-stopped atau always	Hidup lagi	Hidup lagi juga
on-failure	Hidup lagi	Tetap mati
no	Tetap mati	Tetap mati

Kalau tidak berhasil

Gejala	Penyebab	Solusi
HolyArrs tidak bisa menonaktifkan sebuah bagian	Bagian lain membutuhkannya	Nonaktifkan dulu bagian itu, seperti kata pesannya.
Mulai ulang malah mematikan HolyArrs untuk seterusnya	Kebijakan restart no	Mulai containernya dan setel restart: unless-stopped.
Kontrol ditolak	Login lokal tanpa kata sandi, atau kuncinya tidak punya control	Masuk dengan kata sandi kamu.
Sebuah tugas tetap gagal	Tugas itu butuh kamu	Baca alasannya di /health, perbaiki, lalu klik Restart untuk tugas itu.

Solusi lainnya: Pemecahan masalah.

Untuk yang mahir

Status kondisi

/health, Settings > Parts dan GET /api/v1/health/states mencantumkan setiap tugas latar belakang, bagian, dan aplikasi tertaut beserta status dan alasannya.

Status	Arti
off	Dinonaktifkan, dijeda, atau tidak dimulai dalam mode aman.
starting	Sedang dimulai, atau belum diperiksa.
running	Berfungsi.
retrying	Gagal; HolyArrs mencoba lagi, dengan jeda yang makin lama.
failed	Crash, macet, atau butuh kamu. Alasannya menyebutkan apa yang harus dilakukan.

Tugas yang crash tampil failed, lalu retrying, lalu mulai lagi. Login, pustaka, dan backup tetap bekerja selama itu. Tugas yang macet beres dengan mulai ulang penuh.

Memori dan mode memori rendah

HolyArrs berusaha tetap di bawah 384 MiB, yang muat di batas container 500 MB. Untuk menyetel target kamu sendiri, atur GOMEMLIMIT ke sekitar 80 persen dari memori container.

Mode memori rendah menyimpan lebih sedikit di memori dan lebih banyak membaca dari database. Beberapa halaman butuh waktu sedikit lebih lama, dan pekerjaan latar belakang seperti penyalinan katalog musik berjalan lebih jarang.

Pengaturan	Efek
(bawaan, Linux)	Aktif sendiri pada memori sekitar 2.5 GiB atau kurang.
HOLYARRS_LOW_MEMORY=1	Selalu aktif.
HOLYARRS_LOW_MEMORY=0	Selalu nonaktif.

Baris log pertama menyebutkan apakah mode ini aktif dan kenapa.

Scope kunci API

Buat kunci di Settings > API > API keys (kunci API) lalu kirim di header X-Api-Key.

Scope	Menjangkau
read	Pustaka, tugas, unduhan, riwayat, kondisi, pengaturan. Rahasia disamarkan.
health_read	Hanya status kondisi. Untuk alat pemantauan.
write	Setiap perubahan kecuali rute admin dan kontrol.
admin	Orang, undangan, batas permintaan, kunci API, kata sandi dan dua faktor, pengaturan login, backup.
control	Kontrol di halaman ini. Hanya pemilik dan admin yang bisa memberikannya.
all	read, write dan admin. Bukan control.

Sebuah kunci tidak pernah bisa lebih dari orang yang membuatnya. Scope tidak bisa diubah nanti; buat kunci baru. Semua rute beserta scope-nya: /api/v1/openapi.json.

Terkait

• Pemeriksaan kondisi
• Backup
• Rute API