NAS, Synology ve Unraid

HolyArrs’ı NAS’ında doğru klasörler, doğru sahip ve doğru yeniden başlatma ayarıyla çalıştır. Önce Kurulum sayfasını oku.

Başlamadan önce

• /config yerel bir birime ya da havuza gider. Asla ağ paylaşımına değil.
• Medya, içinde downloads, movies, tv ve music olan tek bir ortak klasörde durur. Her birini ayrı bağla ya da hardlink (sabit bağlantı) için üst klasörü bir kez bağla. Bkz. Klasörler.

NAS’ını ayarla

::tab[Synology]

1. File Station’da docker/holyarrs/config klasörünü oluştur.
2. İçinde downloads, movies, tv ve music olan tek bir media ortak klasörü oluştur.
3. Container Manager’da Project > Create’i (proje > oluştur) aç ve Kurulum sayfasındaki Compose dosyasını yapıştır.
4. Birimleri şöyle ayarla: /volume1/docker/holyarrs/config:/config, sonra /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music ve /volume1/media/downloads:/downloads.
5. PUID ve PGID değerlerini kendi kullanıcına ayarla; çoğunlukla 1026 ve 100. SSH’ta id <user> ile kontrol et.
6. O kullanıcıya media üzerinde okuma ve yazma izni ver: Control Panel > Shared Folder > Edit > Permissions.
7. Enable auto-restart’ı (otomatik yeniden başlatmayı etkinleştir) işaretle.
8. http://your-server:6262 adresini aç. İlk açılış sihirbazını görmelisin. /movies, /tv ve /music klasörlerini Kütüphane klasörü olarak ekle.

::tab[Unraid]

Henüz Community Applications şablonu yok, bu yüzden konteyneri elle ekle.

1. Docker sekmesinde HolyArrs imajıyla bir konteyner ekle.
2. 6262 portunu eşle.
3. /config’i bir havuz yoluna eşle, örneğin /mnt/<pool>/appdata/holyarrs. <pool> havuzunun adıdır. /mnt/user/appdata olmaz.
4. Medya klasörlerini /movies, /tv, /music ve /downloads yollarına eşle; disk ya da havuz yolları kullan, örneğin /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music ve /mnt/<pool>/media/downloads:/downloads.
5. PUID=99, PGID=100 (Unraid’in nobody:users kullanıcısı) ve UMASK=022 ayarla.
6. Konteyner için otomatik başlatmayı aç, böylece kendiliğinden yeniden başlar.
7. http://your-server:6262 adresini aç. İlk açılış sihirbazını görmelisin.

::tab[QNAP]

1. Container/holyarrs/config klasörünü ve içinde downloads, movies, tv ve music olan tek bir media paylaşımını oluştur.
2. Container Station’da Applications > Create’i aç ve Compose dosyasını yapıştır.
3. Şunları kullan: /share/Container/holyarrs/config:/config, sonra /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music ve /share/media/downloads:/downloads.
4. PUID ve PGID değerlerini media paylaşımının sahibine ayarla.
5. Yeniden başlatma ilkesini unless-stopped yap.
6. http://your-server:6262 adresini aç. İlk açılış sihirbazını görmelisin.

::tab[TrueNAS SCALE]

1. 2 dataset oluştur: apps/holyarrs-config ve media; media içine downloads, movies, tv ve music klasörlerini koy.
2. Apps’te Compose dosyasıyla YAML’dan özel bir uygulama ekle.
3. Şunları kullan: /mnt/<pool>/apps/holyarrs-config:/config, sonra /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music ve /mnt/<pool>/media/downloads:/downloads.
4. PUID ve PGID değerlerini dataset’in sahibine ayarla; çoğunlukla 568. Dataset ACL’inde o kullanıcıya yazma izni ver.
5. Yeniden başlatma ilkesini unless-stopped yap.
6. http://your-server:6262 adresini aç. İlk açılış sihirbazını görmelisin.

Her NAS’ta: PUID kullanıcısına NAS izin ekranından medya klasöründe okuma ve yazma izni ver; yapılandırma klasörünü HolyArrs kendisi halleder. Konteyner için otomatik yeniden başlatmayı aç (Docker’ın unless-stopped ilkesi).

Ek alan tutmayan ve anında biten hardlink’ler için dört klasör yerine tek medya klasörünü bağla ve indiricine de aynı bağlamayı aynı yolda ver. Bkz. Medya klasörleri.

Seçenekler

Ayrı bağlama noktaları

/movies, /tv, /music ve /downloads klasörlerini tek tek bağlamak çalışır, ama her içe aktarma tam kopya olur. Her bağlama noktası konteynerin içinde ayrı bir dosya sistemidir ve hardlink dosya sistemleri arasında geçemez. Tek bir üst klasörün altındaki ayrı paylaşımlar ya da dataset’ler de kopyalanır. HolyArrs’ın kopyalaması gerektiğinde Settings > Library folders (Ayarlar > Kütüphane klasörleri) seni uyarır.

Disklerin uyumasına izin ver

Şu işler medya disklerini uyandırır. Ne sıklıkta çalışacaklarını Schedules (zamanlamalar) sayfasından değiştir.

İş	Ne okur
Rescan the Library (Kütüphaneyi yeniden tara)	Her Kütüphane klasörü. Diskleri en çok uyandıran bu.
Check Library folders (Kütüphane klasörlerini denetle)	Her klasörün bilgileri ve boş alanı. Yazma ve hardlink denemesi yalnızca başlangıçta, Run now’da (şimdi çalıştır) ve klasörler değişince çalışır.
Look for missing subtitles (eksik altyazıları ara), Look for better subtitles (daha iyi altyazıları ara)	Her videonun yanındaki klasör.

• /config ve indirme klasörünü bir SSD’ye ya da önbellek havuzuna koy.
• /config’in bulunduğu diskte 1 GB boş yer bırak. Altına düşünce sağlık uyarısı alırsın.
• Unraid’de Cache Directories eklentisi klasör listelerini bellekte tutar, böylece taramalar diske inmez.
• İçe aktarma, ekleme ve silme, çalıştıkları diske o an dokunur.
• Yeniden taramayı 7 günde bire ayarla ya da kapat. Elle eklediğin dosyalar o zaman yalnızca Rescan the Library için Run now’a basınca bulunur.
• Seed eden bir torrent dosyasını okur. Kütüphaneye hardlink’liyse, seed bitene kadar o disk uyanık kalır.

Çalışmazsa

Belirti	Neden	Çözüm
Açılmıyor, bir FUSE yolunu, ağ paylaşımını ya da Unraid kullanıcı paylaşımını anıyor	/config yerel diskte değil (Unraid’de /mnt/user’ı gösteriyor)	/config’i yerel bir disk ya da havuz yoluna taşı, örneğin /mnt/<pool>/appdata/holyarrs.
Yeniden başlatma ya da geri yüklemeden sonra durmuş kalıyor	Otomatik yeniden başlatma kapalı	Aç ve konteyneri başlat.
İçe aktarmalar izin hatasıyla başarısız oluyor	PUID kullanıcısı medyaya yazamıyor	NAS izin ekranında okuma ve yazma izni ver (Synology’de: Control Panel > Shared Folder > Edit > Permissions).
İçe aktarmalar hardlink değil, kopya	İndirmeler ve Kütüphane farklı bağlama noktalarında ya da disklerde	Tek ortak klasörü HolyArrs’ta ve indiricide bir kez bağla.

Daha fazla çözüm: Sorun giderme.

Uzmanlar için

HolyArrs neden bazı yapılandırma yollarını reddeder

HolyArrs veritabanlarını /config içinde tutar. Ağ paylaşımları ve FUSE yolları bunları bozabilir, bu yüzden HolyArrs böyle bir yolda başlamayı reddeder ve nedenini söyler.

Unraid’de /mnt/user bir FUSE yoludur. Bir havuz yolu kullan ya da appdata’yı Exclusive yap: Settings > Global Share Settings içinde Permit exclusive shares’ı aç, sonra Shares > appdata için birincil depolamayı tek bir havuza, ikincil depolamayı none’a ayarla.

Var olmayan bir havuzdaki /config yolu belleğe düşer ve yeniden başlatmada kaybolur. HolyArrs bunu da reddeder. Medya için de /mnt/user kullanma; üzerinden hardlink’ler başarısız olabilir.

Otomatik yeniden başlatma neden önemli

Uygulamadan yeniden başlatma, güvenli mod ve yedek geri yükleme, HolyArrs’ı durdurur ve Docker’ın tekrar başlatmasını bekler. Otomatik yeniden başlatma olmadan durmuş kalır. Bkz. Modüller ve güvenli mod.

Port ve güncellemeler

• 6262 portunu yalnızca ev ağına eşle. Dışarıdan birine açmadan önce Güvenlik temelleri bölümünü oku.
• Güncellemek için yeni imajı çek ve konteyneri yeniden oluştur. Verilerin /config içinde kalır. Bkz. Güncellemeler.

İlgili

• Klasörler
• Kütüphane klasörleri
• Zamanlamalar