हिस्से और सेफ़ मोड

जो हिस्से आप इस्तेमाल नहीं करते उन्हें बंद करें, कुछ टूट जाए तो सेफ़ मोड में शुरू करें, और 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 के साथ शुरू करें। ठीक करने के बाद इसे हटा दें: दोनों हर शुरुआत को सेफ़ मोड में रखते हैं।

विकल्प

हिस्सा बंद होने पर क्या रुकता है

हिस्सा	क्या रुकता है	क्या चलता रहता है
Movies	फ़िल्मों के पेज और मेन्यू आइटम, जोड़ना, खोजना, रीफ़्रेश करना	जो डाउनलोड पहले से आपके डाउनलोडर में हैं, उन पर नज़र रखी जाती है। फ़ाइलें रहती हैं।
TV shows	शो के पेज, जोड़ना, खोजना, सीज़न की खोज, रीफ़्रेश	Movies जैसा ही।
Music	कलाकार और एल्बम के पेज, संगीत की सेटिंग, कलाकार के रीफ़्रेश, एल्बम की खोज	Movies जैसा ही।
Subtitles	सबटाइटल की सेटिंग, गायब सबटाइटल वाला पेज, खोज और चेक	आपके वीडियो के पास रखी सबटाइटल फ़ाइलें रहती हैं।
Requests	रिक्वेस्ट के पेज और टाइटल माँगना	मौजूदा रिक्वेस्ट रहती हैं और हिस्सा दोबारा चालू होने पर लौट आती हैं।

हमेशा चालू: साइन-इन और अकाउंट, लाइब्रेरी फ़ोल्डर, सोर्स, डाउनलोडर और डाउनलोड, अलर्ट, हिस्ट्री, बैकअप, हेल्थ चेक, सेटिंग और API।

• Subtitles को Movies या TV shows चाहिए। Requests को Movies, TV shows या Music चाहिए। जो बदलाव इसे तोड़ता है, HolyArrs उसे मना कर देता है और बताता है कि पहले क्या बदलना है।
• बंद हिस्से का कतार में लगा जॉब इंतज़ार करता है और हिस्सा चालू होते ही चलता है।
• हिस्सा बंद करने से मेमोरी नहीं बचती। सब कुछ एक ही प्रोग्राम में चलता है।

रीस्टार्ट, रोकना और बंद करना

Settings > Danger zone (ओनर और एडमिन) में Restart HolyArrs, Restart in safe mode और Shut down (बंद करें) हैं, साथ ही हर बैकग्राउंड टास्क, जैसे बैकअप या डाउनलोड सिंक, के लिए Pause (रोकें), Resume (फिर शुरू करें) और Restart (रीस्टार्ट करें)।

• जो कंट्रोल कुछ बंद करते हैं, वे 60 s के अंदर आपसे पुष्टि माँगते हैं।
• इस्तेमाल किया गया हर कंट्रोल आपके नाम के साथ History (हिस्ट्री) में लिखा जाता है।
• पासवर्ड से साइन इन करना ज़रूरी है। लोकल नेटवर्क पर बिना पासवर्ड वाला साइन-इन मना कर दिया जाता है।

Restart HolyArrs को ठीक से बंद करता है और Docker को उसे दोबारा शुरू करने देता है, इसलिए restart: unless-stopped सेट करें।

रीस्टार्ट पॉलिसी	Restart	Shut down
unless-stopped या always	वापस आ जाता है	यह भी वापस आ जाता है
on-failure	वापस आ जाता है	बंद रहता है
no	बंद रहता है	बंद रहता है

अगर काम न करे

लक्षण	वजह	हल
HolyArrs कोई हिस्सा बंद नहीं कर पाता	किसी दूसरे हिस्से को उसकी ज़रूरत है	जैसा संदेश कहता है, पहले वह हिस्सा बंद करें।
Restart ने HolyArrs को पूरी तरह बंद कर दिया	रीस्टार्ट पॉलिसी no है	कंटेनर शुरू करें और restart: unless-stopped सेट करें।
कंट्रोल मना कर दिए जाते हैं	बिना पासवर्ड वाला लोकल साइन-इन, या कुंजी में control नहीं है	अपने पासवर्ड से साइन इन करें।
कोई टास्क failed ही रहता है	उसे आपकी ज़रूरत है	/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 (सेटिंग > API > API कुंजी) में एक कुंजी बनाएं और उसे X-Api-Key हेडर में भेजें।

स्कोप	कहाँ तक पहुँचता है
read	लाइब्रेरी, जॉब, डाउनलोड, हिस्ट्री, हेल्थ, सेटिंग। सीक्रेट छिपे रहते हैं।
health_read	सिर्फ़ हेल्थ की स्थितियाँ। मॉनिटरिंग टूल के लिए।
write	एडमिन रूट और कंट्रोल को छोड़कर हर बदलाव।
admin	लोग, इनवाइट, रिक्वेस्ट की सीमा, API कुंजी, पासवर्ड और टू-फ़ैक्टर, साइन-इन की सेटिंग, बैकअप।
control	इस पेज के कंट्रोल। इसे सिर्फ़ ओनर और एडमिन दे सकते हैं।
all	read, write और admin। control नहीं।

कोई कुंजी उसे बनाने वाले व्यक्ति से ज़्यादा कभी नहीं कर सकती। स्कोप बाद में बदले नहीं जा सकते; नई कुंजी बनाएं। हर रूट और उसका स्कोप: /api/v1/openapi.json।

इससे जुड़े पेज

• हेल्थ चेक
• बैकअप
• API रूट