NAS, Synology, dan Unraid

Jalankan HolyArrs di NAS kamu dengan folder, pemilik, dan pengaturan restart yang benar. Baca Pemasangan dulu.

Sebelum mulai

• /config ditaruh di volume atau pool lokal. Jangan pernah di berbagi jaringan.
• Media ditaruh di satu folder bersama berisi downloads, movies, tv, dan music. Mount masing-masing, atau mount folder induknya sekali untuk hardlink (tautan keras). Lihat Folder.

Siapkan NAS kamu

::tab[Synology]

1. Di File Station, buat docker/holyarrs/config.
2. Buat satu folder bersama media berisi downloads, movies, tv, dan music.
3. Di Container Manager, buka Project > Create lalu tempel file Compose dari Pemasangan.
4. Setel volume ke /volume1/docker/holyarrs/config:/config, lalu /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music, dan /volume1/media/downloads:/downloads.
5. Setel PUID dan PGID ke pengguna kamu, sering kali 1026 dan 100. Periksa dengan id <user> lewat SSH.
6. Beri pengguna itu izin baca dan tulis di media: Control Panel > Shared Folder > Edit > Permissions.
7. Centang Enable auto-restart.
8. Buka http://your-server:6262. Kamu akan melihat wizard pertama kali dijalankan. Tambahkan /movies, /tv, dan /music sebagai folder pustaka.

::tab[Unraid]

Belum ada template Community Applications, jadi tambahkan container secara manual.

1. Di tab Docker, tambahkan container dengan image HolyArrs.
2. Petakan port 6262.
3. Petakan /config ke path pool, seperti /mnt/<pool>/appdata/holyarrs. <pool> adalah nama pool kamu. Bukan /mnt/user/appdata.
4. Petakan folder media kamu ke /movies, /tv, /music, dan /downloads, dengan path disk atau pool, misalnya /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music, dan /mnt/<pool>/media/downloads:/downloads.
5. Setel PUID=99, PGID=100 (nobody:users milik Unraid) dan UMASK=022.
6. Aktifkan auto-start untuk container, supaya hidup lagi dengan sendirinya.
7. Buka http://your-server:6262. Kamu akan melihat wizard pertama kali dijalankan.

::tab[QNAP]

1. Buat Container/holyarrs/config dan satu share media berisi downloads, movies, tv, dan music.
2. Di Container Station, buka Applications > Create lalu tempel file Compose.
3. Pakai /share/Container/holyarrs/config:/config, lalu /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music, dan /share/media/downloads:/downloads.
4. Setel PUID dan PGID ke pemilik share media.
5. Setel kebijakan restart ke unless-stopped.
6. Buka http://your-server:6262. Kamu akan melihat wizard pertama kali dijalankan.

::tab[TrueNAS SCALE]

1. Buat 2 dataset: apps/holyarrs-config dan media, dengan folder downloads, movies, tv, dan music di dalam media.
2. Di Apps, tambahkan custom app dari YAML dengan file Compose.
3. Pakai /mnt/<pool>/apps/holyarrs-config:/config, lalu /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music, dan /mnt/<pool>/media/downloads:/downloads.
4. Setel PUID dan PGID ke pemilik dataset, sering kali 568. Beri pengguna itu izin tulis di ACL dataset.
5. Setel kebijakan restart ke unless-stopped.
6. Buka http://your-server:6262. Kamu akan melihat wizard pertama kali dijalankan.

Di semua NAS: beri pengguna PUID izin baca dan tulis di folder media lewat layar izin NAS; folder konfigurasi diurus HolyArrs sendiri. Aktifkan auto-restart untuk container (kebijakan unless-stopped milik Docker).

Untuk hardlink, yang tidak memakai ruang tambahan dan selesai seketika, mount satu folder media sebagai ganti keempatnya, dan beri downloader kamu mount yang sama di path yang sama. Lihat Folder media.

Pilihan

Mount terpisah

Memasang /movies, /tv, /music, dan /downloads satu per satu bisa berjalan, tetapi setiap impor menjadi salinan penuh. Setiap mount adalah sistem file sendiri di dalam container, dan hardlink tidak bisa melintasi sistem file. Berbagi atau dataset terpisah di bawah satu induk juga menyalin. Settings > Library folders (pengaturan > folder pustaka) memberi peringatan kalau HolyArrs harus menyalin.

Biarkan disk kamu tidur

Tugas-tugas ini membangunkan disk media. Ubah seberapa sering dijalankan di halaman Schedules (jadwal).

Tugas	Yang dibacanya
Rescan the Library (pindai ulang pustaka)	Setiap folder pustaka. Paling sering membangunkan disk.
Check Library folders (periksa folder pustaka)	Detail dan ruang kosong tiap folder. Uji tulis dan hardlink hanya berjalan saat dimulai, saat Run now (jalankan sekarang), dan saat folder berubah.
Look for missing subtitles, Look for better subtitles	Folder di samping setiap video.

• Taruh /config dan folder unduhan di SSD atau pool cache.
• Sisakan 1 GB kosong di disk yang menyimpan /config. Di bawah itu kamu mendapat peringatan kondisi.
• Di Unraid, plugin Cache Directories menyimpan daftar folder di memori, jadi pemindaian tidak menyentuh disk.
• Impor, penambahan, dan penghapusan menyentuh disk yang dikerjakan, saat itu terjadi.
• Setel pindai ulang menjadi setiap 7 hari atau nonaktif. File yang kamu tambahkan manual baru ditemukan kalau kamu klik Run now di Rescan the Library.
• Torrent yang sedang seeding membaca filenya. Kalau di-hardlink ke pustaka kamu, disk itu tetap bangun sampai seeding berhenti.

Kalau tidak berhasil

Gejala	Penyebab	Solusi
Tidak mau mulai, menyebut path FUSE, berbagi jaringan, atau user share Unraid	/config tidak ada di disk lokal (di Unraid, mengarah ke /mnt/user)	Pindahkan /config ke disk lokal atau path pool, seperti /mnt/<pool>/appdata/holyarrs.
Tetap berhenti setelah restart atau pemulihan	Auto-restart nonaktif	Aktifkan lalu mulai container.
Impor gagal dengan kesalahan izin	Pengguna PUID tidak bisa menulis ke media	Beri izin baca dan tulis di layar izin NAS (di Synology: Control Panel > Shared Folder > Edit > Permissions).
Impor berupa salinan, bukan hardlink	Unduhan dan pustaka ada di mount atau disk yang berbeda	Mount satu folder bersama sekali, di HolyArrs dan di downloader.

Solusi lainnya: Pemecahan masalah.

Untuk yang mahir

Kenapa HolyArrs menolak beberapa path konfigurasi

HolyArrs menyimpan database di /config. Berbagi jaringan dan path FUSE bisa merusaknya, jadi HolyArrs menolak mulai di sana dan menjelaskan alasannya.

Di Unraid, /mnt/user adalah path FUSE. Pakai path pool, atau jadikan appdata Exclusive: aktifkan Permit exclusive shares di Settings > Global Share Settings, lalu setel Shares > appdata ke penyimpanan primer di satu pool dan penyimpanan sekunder ke none.

Path /config di pool yang tidak ada akan masuk ke memori dan hilang saat reboot. HolyArrs menolak itu juga. Hindari /mnt/user untuk media juga; hardlink yang melintasinya bisa gagal.

Kenapa auto-restart penting

Mulai ulang di aplikasi, mode aman, dan pemulihan backup semuanya menghentikan HolyArrs dan mengandalkan Docker untuk memulainya lagi. Tanpa auto-restart, ia tetap berhenti. Lihat Bagian dan mode aman.

Port dan update

• Petakan port 6262 ke jaringan rumah kamu saja. Baca Dasar keamanan sebelum membukanya untuk orang di luar.
• Untuk update, tarik image baru dan buat ulang container. Data kamu tetap di /config. Lihat Update.

Terkait

• Folder
• Folder pustaka
• Jadwal