অংশ ও সেফ মোড

যে অংশ ব্যবহার করেন না সেগুলো বন্ধ রাখুন, কিছু ভেঙে গেলে সেফ মোডে চালু করুন, আর ব্রাউজার থেকে HolyArrs রিস্টার্ট করুন।

একটি অংশ চালু বা বন্ধ করুন

HolyArrs-এর 5টি অংশ: Movies (মুভি), TV shows (সিরিজ), Music (মিউজিক), Subtitles (সাবটাইটেল) আর Requests (অনুরোধ)। প্রথমবার চালু করার উইজার্ডেই আপনি এগুলো বেছে নেন।

1. Settings > Parts (সেটিংস > অংশ) খুলুন।
2. কোনো অংশের পাশে Turn on (চালু করুন) বা Turn off (বন্ধ করুন) ক্লিক করুন। ওই অংশের মেনুর আইটেমগুলো আসতে বা চলে যেতে দেখবেন।

কিছুই মোছা হয় না। অংশটি আবার চালু করলে যেখানে ছিল সেখান থেকেই চলে।

সেফ মোডে চালু করুন

সেফ মোডে শুধু মূল জিনিসগুলো চালু হয়। কিছু HolyArrs-কে চালু হতে বা কাজ করতে না দিলে এটি কাজে আসে। আপনি সাইন ইন করতে, লাইব্রেরি দেখতে, সেটিংস বদলাতে আর ব্যাকআপ নিতে বা রিস্টোর করতে পারেন। সার্চ, যোগ করা, রিফ্রেশ, ডাউনলোড আর ইমপোর্ট পরের স্বাভাবিক চালু পর্যন্ত অপেক্ষা করে।

1. Settings > Danger zone (সেটিংস > বিপদ এলাকা) খুলুন।
2. Restart in safe mode (সেফ মোডে রিস্টার্ট) ক্লিক করুন। প্রতিটি পাতায় একটি ব্যানার দেখতে পাবেন।
3. সমস্যা ঠিক করুন, তারপর Restart HolyArrs (HolyArrs রিস্টার্ট) ক্লিক করুন। পরের বার স্বাভাবিকভাবে চালু হবে।

পাতাটিতে ঢুকতে না পারলে Compose-এ HOLYARRS_SAFE_MODE=1 দিন বা -safe-mode দিয়ে চালু করুন। ঠিক করার পরে এটি সরিয়ে দিন: দুটোই প্রতিবার সেফ মোডে চালু রাখে।

বিকল্প

অংশ বন্ধ থাকলে কী থামে

অংশ	কী থামে	কী চলতে থাকে
মুভি	মুভির পাতা আর মেনু আইটেম, যোগ করা, সার্চ, রিফ্রেশ	আপনার ডাউনলোডারে থাকা ডাউনলোডগুলো তখনও অনুসরণ করা হয়। ফাইল থেকে যায়।
সিরিজ	সিরিজের পাতা, যোগ করা, সার্চ, সিজন সার্চ, রিফ্রেশ	মুভির মতোই।
মিউজিক	শিল্পী ও অ্যালবামের পাতা, মিউজিক সেটিংস, শিল্পী রিফ্রেশ, অ্যালবাম সার্চ	মুভির মতোই।
সাবটাইটেল	সাবটাইটেল সেটিংস, নেই-এমন সাবটাইটেলের পাতা, সার্চ আর যাচাই	আপনার ভিডিওর পাশের সাবটাইটেল ফাইল থেকে যায়।
অনুরোধ	অনুরোধের পাতা আর টাইটেল চাওয়া	আগের অনুরোধগুলো থাকে এবং অংশটি আবার চালু হলে ফিরে আসে।

সব সময় চালু থাকে: সাইন ইন ও অ্যাকাউন্ট, লাইব্রেরি ফোল্ডার, সোর্স, ডাউনলোডার ও ডাউনলোড, অ্যালার্ট, হিস্ট্রি, ব্যাকআপ, হেলথ চেক, সেটিংস আর API।

• সাবটাইটেলের জন্য মুভি বা সিরিজ লাগে। অনুরোধের জন্য মুভি, সিরিজ বা মিউজিক লাগে। এটি ভাঙে এমন পরিবর্তন HolyArrs প্রত্যাখ্যান করে আর আগে কী বদলাতে হবে তা বলে দেয়।
• বন্ধ থাকা অংশের সারিতে থাকা কাজ অপেক্ষা করে আর অংশটি চালু হলে চলে।
• অংশ বন্ধ করলে মেমরি বাঁচে না। সবকিছু একটি প্রোগ্রামেই চলে।

রিস্টার্ট, বিরতি ও বন্ধ করা

Settings > Danger zone-এ (মালিক ও অ্যাডমিন) আছে Restart HolyArrs, Restart in safe mode আর Shut down (বন্ধ করুন), সঙ্গে প্রতিটি ব্যাকগ্রাউন্ড কাজের, যেমন ব্যাকআপ বা ডাউনলোড সিঙ্কের, জন্য Pause (বিরতি), Resume (আবার চালু) আর Restart।

• কিছু থামিয়ে দেয় এমন কন্ট্রোল 60 সেকেন্ডের মধ্যে আপনাকে নিশ্চিত করতে বলে।
• ব্যবহার করা প্রতিটি কন্ট্রোল আপনার নামসহ হিস্ট্রিতে লেখা হয়।
• পাসওয়ার্ড দিয়ে সাইন ইন করা লাগে। আপনার লোকাল নেটওয়ার্কে পাসওয়ার্ড ছাড়া সাইন ইন প্রত্যাখ্যাত হয়।

রিস্টার্ট HolyArrs-কে ঠিকমতো বন্ধ করে আর Docker-কে আবার চালু করতে দেয়, তাই restart: unless-stopped দিন।

রিস্টার্ট পলিসি	রিস্টার্ট	বন্ধ করা
unless-stopped বা always	ফিরে আসে	এটিও ফিরে আসে
on-failure	ফিরে আসে	বন্ধ থাকে
no	বন্ধ থাকে	বন্ধ থাকে

কাজ না করলে

লক্ষণ	কারণ	সমাধান
HolyArrs একটি অংশ বন্ধ করতে পারছে না	আরেকটি অংশের ওটি দরকার	বার্তায় যা বলা আছে সেই অংশটি আগে বন্ধ করুন।
রিস্টার্ট HolyArrs-কে একেবারে বন্ধ করে দিয়েছে	রিস্টার্ট পলিসি no	কন্টেইনার চালু করুন আর restart: unless-stopped দিন।
কন্ট্রোল প্রত্যাখ্যাত হচ্ছে	পাসওয়ার্ড ছাড়া লোকাল সাইন ইন, বা কীয়ের control নেই	পাসওয়ার্ড দিয়ে সাইন ইন করুন।
একটি কাজ ব্যর্থ অবস্থায় থেকে যাচ্ছে	আপনাকে কিছু করতে হবে	/health-এ তার কারণ পড়ুন, ঠিক করুন, ওই কাজের Restart ক্লিক করুন।

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

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

হেলথ স্টেট

/health, Settings > Parts আর GET /api/v1/health/states প্রতিটি ব্যাকগ্রাউন্ড কাজ, অংশ আর সংযুক্ত অ্যাপ স্টেট ও কারণসহ তালিকাভুক্ত করে।

স্টেট	মানে
off	বন্ধ করা হয়েছে, বিরতিতে আছে, বা সেফ মোডে চালু হয়নি।
starting	চালু হচ্ছে, বা এখনো যাচাই হয়নি।
running	কাজ করছে।
retrying	ব্যর্থ হয়েছে; HolyArrs আবার চেষ্টা করে, প্রতিবার আরও বেশি অপেক্ষা করে।
failed	ক্র্যাশ করেছে, আটকে গেছে বা আপনাকে কিছু করতে হবে। কারণে বলা থাকে কী করতে হবে।

ক্র্যাশ করা কাজ প্রথমে failed, তারপর retrying দেখায়, তারপর আবার চালু হয়। এর মধ্যে সাইন ইন, লাইব্রেরি আর ব্যাকআপ কাজ করতে থাকে। আটকে যাওয়া কাজ পুরো রিস্টার্টে ঠিক হয়।

মেমরি ও কম-মেমরি মোড

HolyArrs 384 MiB-এর নিচে থাকার লক্ষ্য রাখে, যা 500 MB কন্টেইনার সীমার মধ্যে ধরে। নিজের লক্ষ্য ঠিক করতে GOMEMLIMIT কন্টেইনারের মেমরির প্রায় 80 শতাংশ দিন।

কম-মেমরি মোডে কম জিনিস মেমরিতে থাকে আর ডেটাবেস থেকে বেশি পড়া হয়। কিছু পাতা একটু বেশি সময় নেয়, আর মিউজিক ক্যাটালগ কপির মতো ব্যাকগ্রাউন্ড কাজ কম ঘন ঘন চলে।

সেটিং	ফল
(ডিফল্ট, Linux)	প্রায় 2.5 GiB বা তার কম মেমরি থাকলে নিজে থেকেই চালু হয়।
HOLYARRS_LOW_MEMORY=1	সব সময় চালু।
HOLYARRS_LOW_MEMORY=0	সব সময় বন্ধ।

প্রথম লগ লাইনে বলা থাকে এটি চালু কি না আর কেন।

API কীয়ের স্কোপ

Settings > API > API keys-এ কী বানান আর X-Api-Key হেডারে পাঠান।

স্কোপ	কী পর্যন্ত পৌঁছায়
read	লাইব্রেরি, কাজ, ডাউনলোড, হিস্ট্রি, হেলথ, সেটিংস। গোপন মান ঢাকা।
health_read	শুধু হেলথ স্টেট। মনিটরিং টুলের জন্য।
write	অ্যাডমিন রুট আর কন্ট্রোল বাদে সব পরিবর্তন।
admin	মানুষ, আমন্ত্রণ, অনুরোধের সীমা, API কী, পাসওয়ার্ড ও টু-ফ্যাক্টর, সাইন ইন সেটিংস, ব্যাকআপ।
control	এই পাতার কন্ট্রোলগুলো। শুধু মালিক ও অ্যাডমিন এটি দিতে পারেন।
all	read, write আর admin। control নয়।

কোনো কী যিনি বানিয়েছেন তাঁর চেয়ে বেশি কিছু কখনো করতে পারে না। স্কোপ পরে বদলানো যায় না; নতুন কী বানান। প্রতিটি রুট আর তার স্কোপ: /api/v1/openapi.json।

সংশ্লিষ্ট

• হেলথ চেক
• ব্যাকআপ
• API রুট