NAS, Synology ও Unraid

সঠিক ফোল্ডার, মালিক আর রিস্টার্ট সেটিং দিয়ে আপনার NAS-এ HolyArrs চালান। আগে ইনস্টল পড়ুন।

শুরু করার আগে

• /config থাকবে লোকাল ভলিউম বা পুলে। কখনো নেটওয়ার্ক শেয়ারে নয়।
• মিডিয়া থাকবে একটি শেয়ার করা ফোল্ডারে, যার ভেতরে downloads, movies, tv আর music। প্রতিটি আলাদা মাউন্ট করুন, বা hardlink-এর (একই ফাইলের দ্বিতীয় নাম) জন্য প্যারেন্ট ফোল্ডারটি একবার মাউন্ট করুন। দেখুন ফোল্ডার।

আপনার NAS সেটআপ করুন

::tab[Synology]

1. File Station-এ docker/holyarrs/config বানান।
2. media নামে একটি শেয়ার করা ফোল্ডার বানান, যার ভেতরে downloads, movies, tv আর music।
3. Container Manager-এ Project > Create খুলুন আর ইনস্টল পাতার Compose ফাইলটি পেস্ট করুন।
4. ভলিউমগুলো দিন /volume1/docker/holyarrs/config:/config, তারপর /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music আর /volume1/media/downloads:/downloads।
5. PUID আর PGID আপনার ইউজারের মান দিন, প্রায়ই 1026 আর 100। SSH-এ id <user> দিয়ে দেখে নিন।
6. ওই ইউজারকে media-তে পড়া ও লেখার পারমিশন দিন: Control Panel > Shared Folder > Edit > Permissions।
7. Enable auto-restart টিক দিন।
8. http://your-server:6262 খুলুন। প্রথমবার চালু করার উইজার্ড দেখতে পাবেন। /movies, /tv আর /music লাইব্রেরি ফোল্ডার হিসেবে যোগ করুন।

::tab[Unraid]

এখনো কোনো Community Applications টেমপ্লেট নেই, তাই কন্টেইনারটি হাতে যোগ করুন।

1. Docker ট্যাবে HolyArrs ইমেজ দিয়ে একটি কন্টেইনার যোগ করুন।
2. পোর্ট 6262 ম্যাপ করুন।
3. /config একটি পুলের পাথে ম্যাপ করুন, যেমন /mnt/<pool>/appdata/holyarrs। <pool> হলো আপনার পুলের নাম। /mnt/user/appdata নয়।
4. আপনার মিডিয়া ফোল্ডারগুলো /movies, /tv, /music আর /downloads-এ ম্যাপ করুন, ডিস্ক বা পুলের পাথ ব্যবহার করে, যেমন /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music আর /mnt/<pool>/media/downloads:/downloads।
5. PUID=99, PGID=100 (Unraid-এর nobody:users) আর UMASK=022 দিন।
6. কন্টেইনারের জন্য অটো-স্টার্ট চালু করুন, যাতে এটি নিজে থেকে রিস্টার্ট হয়।
7. http://your-server:6262 খুলুন। প্রথমবার চালু করার উইজার্ড দেখতে পাবেন।

::tab[QNAP]

1. Container/holyarrs/config আর একটি media শেয়ার বানান, যার ভেতরে downloads, movies, tv আর music।
2. Container Station-এ Applications > Create খুলুন আর Compose ফাইলটি পেস্ট করুন।
3. ব্যবহার করুন /share/Container/holyarrs/config:/config, তারপর /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music আর /share/media/downloads:/downloads।
4. PUID আর PGID দিন media শেয়ারের মালিকের মান।
5. রিস্টার্ট পলিসি unless-stopped দিন।
6. http://your-server:6262 খুলুন। প্রথমবার চালু করার উইজার্ড দেখতে পাবেন।

::tab[TrueNAS SCALE]

1. 2টি ডেটাসেট বানান: apps/holyarrs-config আর media, যেখানে media-র ভেতরে downloads, movies, tv আর music ফোল্ডার।
2. Apps-এ YAML থেকে একটি কাস্টম অ্যাপ যোগ করুন, Compose ফাইলটি দিয়ে।
3. ব্যবহার করুন /mnt/<pool>/apps/holyarrs-config:/config, তারপর /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music আর /mnt/<pool>/media/downloads:/downloads।
4. PUID আর PGID দিন ডেটাসেটের মালিকের মান, প্রায়ই 568। ডেটাসেটের ACL-এ ওই ইউজারকে লেখার পারমিশন দিন।
5. রিস্টার্ট পলিসি unless-stopped দিন।
6. http://your-server:6262 খুলুন। প্রথমবার চালু করার উইজার্ড দেখতে পাবেন।

সব NAS-এ: NAS-এর পারমিশন স্ক্রিনে PUID ইউজারকে মিডিয়া ফোল্ডারে পড়া ও লেখার পারমিশন দিন; কনফিগ ফোল্ডার HolyArrs নিজেই সামলায়। কন্টেইনারের জন্য অটো-রিস্টার্ট চালু করুন (Docker-এর unless-stopped পলিসি)।

hardlink-এর জন্য, যা বাড়তি জায়গা নেয় না আর সঙ্গে সঙ্গে শেষ হয়, চারটির জায়গায় একটি মিডিয়া ফোল্ডার মাউন্ট করুন, আর ডাউনলোডারকে একই পাথে একই মাউন্ট দিন। দেখুন মিডিয়া ফোল্ডার।

বিকল্প

আলাদা মাউন্ট

/movies, /tv, /music আর /downloads একটি একটি করে মাউন্ট করলেও চলে, কিন্তু প্রতিটি ইমপোর্ট তখন পুরো কপি হয়ে যায়। কন্টেইনারের ভেতরে প্রতিটি মাউন্ট আলাদা ফাইলসিস্টেম, আর hardlink ফাইলসিস্টেম পার হতে পারে না। একই প্যারেন্টের নিচে আলাদা শেয়ার বা ডেটাসেটও কপি করে। HolyArrs-কে কপি করতে হলে Settings > Library folders সতর্ক করে।

আপনার ডিস্কগুলোকে ঘুমাতে দিন

এই কাজগুলো মিডিয়া ডিস্ক জাগিয়ে তোলে। Schedules (সময়সূচি) পাতায় এগুলো কতক্ষণ পরপর চলে তা বদলান।

কাজ	কী পড়ে
Rescan the Library (লাইব্রেরি আবার স্ক্যান)	প্রতিটি লাইব্রেরি ফোল্ডার। সবচেয়ে বেশি ডিস্ক জাগায়।
Check Library folders (লাইব্রেরি ফোল্ডার যাচাই)	প্রতিটি ফোল্ডারের তথ্য আর খালি জায়গা। লেখা ও hardlink-এর টেস্ট চলে শুধু চালু হওয়ার সময়, Run now (এখনই চালান) চাপলে, আর ফোল্ডার বদলালে।
Look for missing subtitles, Look for better subtitles (নেই-এমন সাবটাইটেল খুঁজুন, আরও ভালো সাবটাইটেল খুঁজুন)	প্রতিটি ভিডিওর পাশের ফোল্ডার।

• /config আর ডাউনলোড ফোল্ডার SSD বা ক্যাশ পুলে রাখুন।
• /config যে ডিস্কে আছে সেখানে 1 GB খালি রাখুন। এর নিচে নামলে হেলথ সতর্কতা আসে।
• Unraid-এ Cache Directories প্লাগইন ফোল্ডারের তালিকা মেমরিতে রাখে, ফলে স্ক্যান ডিস্ক ছোঁয় না।
• ইমপোর্ট, যোগ করা আর মোছা যখন ঘটে তখন যে ডিস্কে কাজ করছে সেটি ছোঁয়।
• রিস্ক্যান প্রতি 7 দিনে করুন, বা বন্ধ রাখুন। তখন হাতে যোগ করা ফাইল পাওয়া যায় শুধু Rescan the Library-তে Run now চাপলে।
• সিড হতে থাকা টরেন্ট তার ফাইল পড়ে। সেটি আপনার লাইব্রেরিতে hardlink করা থাকলে সিডিং বন্ধ না হওয়া পর্যন্ত ওই ডিস্ক জেগে থাকে।

কাজ না করলে

লক্ষণ	কারণ	সমাধান
চালু হয় না, একটি FUSE পাথ, নেটওয়ার্ক শেয়ার বা Unraid ইউজার শেয়ারের নাম বলে	/config লোকাল ডিস্কে নেই (Unraid-এ এটি /mnt/user-এর দিকে ইশারা করছে)	/config লোকাল ডিস্ক বা পুলের পাথে সরান, যেমন /mnt/<pool>/appdata/holyarrs।
রিস্টার্ট বা রিস্টোরের পরে বন্ধ থেকে যায়	অটো-রিস্টার্ট বন্ধ	সেটি চালু করুন আর কন্টেইনার চালু করুন।
ইমপোর্ট পারমিশন ত্রুটিতে ব্যর্থ হয়	PUID ইউজার মিডিয়াতে লিখতে পারে না	NAS-এর পারমিশন স্ক্রিনে পড়া ও লেখার পারমিশন দিন (Synology-তে: Control Panel > Shared Folder > Edit > Permissions)।
ইমপোর্ট hardlink না হয়ে কপি হচ্ছে	ডাউনলোড আর লাইব্রেরি আলাদা মাউন্টে বা ডিস্কে	একটি শেয়ার করা ফোল্ডার একবার মাউন্ট করুন, HolyArrs আর ডাউনলোডার, দুটোতেই।

আরও সমাধান: সমস্যার সমাধান।

বিশেষজ্ঞদের জন্য

কিছু কনফিগ পাথ HolyArrs কেন প্রত্যাখ্যান করে

HolyArrs তার ডেটাবেস /config-এ রাখে। নেটওয়ার্ক শেয়ার আর FUSE পাথে ডেটাবেস নষ্ট হতে পারে, তাই এমন পাথে HolyArrs চালু হতে অস্বীকার করে আর কারণ বলে দেয়।

Unraid-এ /mnt/user একটি FUSE পাথ। পুলের পাথ ব্যবহার করুন, অথবা appdata-কে Exclusive করুন: Settings > Global Share Settings-এ Permit exclusive shares চালু করুন, তারপর Shares > appdata-এ একটি পুলকে primary storage আর secondary storage-কে none করুন।

যে পুলের অস্তিত্ব নেই তাতে /config পাথ দিলে সেটি মেমরিতে পড়ে আর রিবুটে হারিয়ে যায়। HolyArrs সেটিও প্রত্যাখ্যান করে। মিডিয়ার জন্যও /mnt/user এড়িয়ে চলুন; এর ওপর দিয়ে hardlink ব্যর্থ হতে পারে।

অটো-রিস্টার্ট কেন জরুরি

অ্যাপের রিস্টার্ট, সেফ মোড আর ব্যাকআপ রিস্টোর, সবই HolyArrs-কে বন্ধ করে আর ধরে নেয় Docker এটি আবার চালু করবে। অটো-রিস্টার্ট না থাকলে এটি বন্ধই থেকে যায়। দেখুন অংশ ও সেফ মোড।

পোর্ট ও আপডেট

• পোর্ট 6262 শুধু আপনার বাসার নেটওয়ার্কে ম্যাপ করুন। বাইরের কারও জন্য খোলার আগে নিরাপত্তার মূল কথা পড়ুন।
• আপডেট করতে নতুন ইমেজ টেনে আনুন আর কন্টেইনারটি আবার বানান। আপনার ডেটা /config-এ থেকে যায়। দেখুন আপডেট।

সংশ্লিষ্ট

• ফোল্ডার
• লাইব্রেরি ফোল্ডার
• সময়সূচি