Pemecahan masalah

Cari gejala kamu, baca penyebabnya, ikuti solusinya. Contoh di sini memakai nama container holyarrs; pakai nama container kamu kalau berbeda.

First 3 checks (3 pemeriksaan pertama)

1. Pantau log: docker logs -f holyarrs. Rahasia disamarkan. Tekan Ctrl+C untuk berhenti mengikuti; container tetap berjalan.
2. Jalankan doctor: docker exec holyarrs /holyarrs doctor. Setiap baris berisi OK, WARN, atau FAIL, dan setiap WARN atau FAIL menjelaskan cara memperbaikinya.
3. Masih buntu? Unduh paket dukungan lalu minta bantuan. Lihat Minta dukungan.

Halaman web tidak bisa dibuka

Gejala: browser tidak bisa terhubung ke http://your-server:6262.

Penyebab: container berhenti, port belum dipetakan, atau ada proxy yang menghalangi.

Solusi:

1. Jalankan docker ps. Kamu akan melihat holyarrs dengan 0.0.0.0:6262->6262.
2. Kalau container terus restart, baca docker logs holyarrs untuk mencari alasannya.
3. Kalau kamu memakai path seperti /holyarrs, lihat Reverse proxy dan URL base.

Permission denied

Gejala: doctor bilang sebuah folder tidak dapat ditulisi, atau impor gagal dengan error izin.

Penyebab: pemilik folder di host tidak cocok dengan PUID dan PGID.

Solusi: jalankan chown yang disarankan doctor, atau atur PUID dan PGID sesuai pemilik folder. Di NAS, beri pengguna itu izin baca dan tulis di layar izin. Lihat NAS, Synology, dan Unraid.

Tidak ada yang terunduh

Gejala: judul tetap hilang dan tidak ada yang sampai ke downloader kamu.

Penyebab: tidak ada sumber yang merespons, downloader belum terhubung, atau tidak ada rilis yang lolos aturan pilihan kamu.

Solusi:

1. Buka Settings > Downloaders (pengaturan > downloader) dan klik Test (uji) pada downloader kamu. Hasilnya harus lulus.
2. Buka Settings > Sources (pengaturan > sumber) dan klik Test pada setiap sumber.
3. Di halaman judul, buka Choose a release (pilih rilis) untuk melihat semua hasil dan alasan kenapa tidak dipilih.

Lihat Downloader dan Sumber.

Sudah diunduh tapi tidak diimpor

Gejala: unduhan sudah selesai di downloader kamu, tetapi judulnya tidak ada di Pustaka.

Penyebab: HolyArrs tidak bisa melihat file di path yang sama, tidak bisa menulis ke folder pustaka, atau impor itu perlu keputusan.

Solusi:

1. Beri HolyArrs dan downloader folder unduhan yang sama di path yang sama, misalnya /downloads, atau isi Downloader’s path (path downloader) dan HolyArrs’ path (path HolyArrs) pada downloader.
2. Jalankan doctor dan perbaiki setiap FAIL pada folder unduhan atau folder pustaka.
3. Periksa daftar unduhan untuk item yang bertanda Needs a decision (perlu keputusan), lalu setujui atau buang rencananya.

Impor berupa salinan, bukan hardlink

Gejala: doctor bilang hardlink tidak berfungsi, atau pemakaian disk jadi dua kali lipat setelah impor.

Penyebab: folder unduhan dan folder pustaka berada di disk atau mount yang berbeda, atau disknya tidak bisa membuat hardlink (DrivePool, banyak NAS dan berbagi SMB, Docker Desktop di Windows). Setiap file tetap hanya ditulis sekali. Unduhan Usenet yang selesai dipindahkan kalau berada di disk yang sama dengan Pustaka.

Solusi: mount satu folder induk bersama ke dalam container, jangan beberapa folder terpisah. Lihat Folder.

HolyArrs tidak mau mulai

Gejala: container berhenti atau langsung restart.

Penyebab: log menyebutkannya. Yang paling umum: /config berada di berbagi jaringan atau path FUSE, atau ada bagian yang rusak.

Solusi:

1. Pindahkan /config ke disk lokal kalau log menyebutkannya. HolyArrs tidak mau menjalankan databasenya di berbagi jaringan.
2. Kalau bukan itu, mulai dalam mode aman, perbaiki dari Settings, lalu mulai ulang seperti biasa.

Ada fitur yang tidak ada

Gejala: fitur yang kamu baca tidak ada di aplikasi.

Penyebab: mungkin fitur itu ditunda di versi ini.

Solusi: lihat Fitur yang ditunda.

Halaman tanpa nama atau gambar

Gejala: judul tampil tanpa poster atau detail.

Penyebab: server metadata tidak bisa dijangkau.

Solusi: periksa DNS dan firewall kamu. Bagian Network di doctor menunjukkan apakah server itu menjawab.

Untuk yang mahir

Pemeriksaan dan opsi doctor

Doctor berjalan di dalam container sebagai pengguna yang sama dengan HolyArrs, jadi doctor mengalami hal yang sama seperti HolyArrs.

Bagian	Menampilkan
App	Versi, pengguna dan grup, umask, apakah berjalan di container.
Config folder	Pemilik, izin, ruang kosong, apakah berada di disk lokal.
Library and download folders	Ada atau tidak, pemilik, dapat ditulisi, ruang kosong, hardlink antara folder unduhan dan folder pustaka.
Network	Apakah nama server metadata dapat di-resolve dan server itu menjawab.
Clock	Waktu, zona waktu (TZ), peringatan kalau jam jelas salah.

Opsi	Fungsinya
-config <folder>	Memeriksa folder konfigurasi HolyArrs lain selain /config.
-json	Mencetak laporan sebagai JSON.

Kode keluar 0 berarti tidak ada yang gagal; 1 berarti ada baris yang berisi FAIL. Laporan tidak pernah menampilkan kunci, kata sandi, atau token. Doctor hanya membaca, kecuali satu file uji kecil yang ditulis lalu dihapusnya. Kalau dijalankan sebagai root, doctor juga menyerahkan folder konfigurasi ke PUID:PGID, seperti saat start biasa.

Kalau HolyArrs terus restart, docker exec gagal. Jalankan doctor di container baru dengan folder yang sama:

docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> -e TZ=<tz> holyarrs/holyarrs:<tag> doctor

Dengan Compose: docker compose run --rm holyarrs doctor.

Pemeriksaan folder saat start

Saat start, HolyArrs memeriksa folder-foldernya dan mencatat satu baris ringkasan, misalnya folders: 4 ok, 1 not writable, lalu satu baris untuk setiap folder bermasalah beserta solusinya. Pemeriksaan ini berhenti setelah 3 detik supaya proses start tidak pernah menggantung. Folder yang terlalu lambat menjawab dianggap belum diperiksa; ini sering terjadi pada disk yang sedang bangun dari tidur atau berbagi jaringan yang lambat. Doctor memeriksanya tanpa batas waktu. Lihat Log.

Tidak ada shell di image

Image hanya berisi program HolyArrs, jadi ukurannya tetap kecil dan menyisakan lebih sedikit celah bagi penyerang. docker exec holyarrs sh gagal karena memang dirancang begitu. Untuk melihat lebih dekat, jalankan helper sekali pakai di sampingnya:

docker run --rm -it --pid container:holyarrs --network container:holyarrs --volumes-from holyarrs busybox sh

Helper ini melihat proses HolyArrs, berbagi jaringannya, dan punya folder yang sama di path yang sama. Helper ini berjalan sebagai root, jadi lihat saja jangan ubah: file yang ditulis sebagai root mungkin tidak bisa dibaca HolyArrs. Untuk menguji sebagai pengguna HolyArrs, tambahkan --user <PUID>:<PGID>.

Cari tahu versinya

docker inspect --format '{{ index .Config.Labels "org.opencontainers.image.version" }}' holyarrs

Bagian App di doctor menampilkan hal yang sama.

Terkait

• Minta dukungan
• Log
• Pemeriksaan kondisi