समस्या सुलझाना

अपना लक्षण खोजें, वजह पढ़ें, हल के चरण अपनाएं। उदाहरणों में कंटेनर का नाम holyarrs है; आपका नाम अलग हो तो वही इस्तेमाल करें।

पहली 3 जाँच

1. लॉग देखें: docker logs -f holyarrs। गोपनीय चीज़ें छिपी रहती हैं। लॉग देखना बंद करने के लिए Ctrl+C दबाएं; कंटेनर चलता रहता है।
2. doctor चलाएं: docker exec holyarrs /holyarrs doctor। हर लाइन OK, WARN या FAIL बताती है, और हर WARN या FAIL के साथ उसे ठीक करने का तरीका लिखा होता है।
3. अब भी अटके हैं? सपोर्ट बंडल डाउनलोड करें और पूछें। मदद पाएं देखें।

वेब पेज नहीं खुलता

लक्षण: ब्राउज़र http://your-server:6262 से कनेक्ट नहीं हो पाता।

वजह: कंटेनर बंद है, पोर्ट मैप नहीं है, या बीच में कोई प्रॉक्सी है।

हल:

1. docker ps चलाएं। holyarrs के साथ 0.0.0.0:6262->6262 दिखना चाहिए।
2. अगर वह बार-बार रीस्टार्ट हो रहा है, तो वजह के लिए docker logs holyarrs पढ़ें।
3. अगर आप /holyarrs जैसा कोई पाथ इस्तेमाल करते हैं, तो रिवर्स प्रॉक्सी और URL base देखें।

Permission denied

लक्षण: doctor कहता है कि किसी फ़ोल्डर में लिखा नहीं जा सकता, या इंपोर्ट अनुमति के एरर के साथ फ़ेल होते हैं।

वजह: होस्ट पर फ़ोल्डर का मालिक PUID और PGID से मेल नहीं खाता।

हल: doctor जो chown सुझाता है वह चलाएं, या PUID और PGID को फ़ोल्डर के मालिक के बराबर सेट करें। NAS पर, अनुमतियों वाली स्क्रीन में उस यूज़र को पढ़ने और लिखने की अनुमति दें। NAS, Synology और Unraid देखें।

कुछ भी डाउनलोड नहीं होता

लक्षण: टाइटल गायब ही रहते हैं और आपके डाउनलोडर तक कुछ नहीं पहुँचता।

वजह: कोई सोर्स जवाब नहीं दे रहा, डाउनलोडर कनेक्ट नहीं है, या कोई रिलीज़ आपके चुनाव के नियमों से पास नहीं होती।

हल:

1. Settings > Downloaders (सेटिंग > डाउनलोडर) खोलें और अपने डाउनलोडर पर Test (टेस्ट) पर क्लिक करें। टेस्ट पास होना चाहिए।
2. Settings > Sources (सेटिंग > सोर्स) खोलें और हर सोर्स पर Test पर क्लिक करें।
3. टाइटल पर Choose a release (रिलीज़ ख़ुद चुनना) खोलें। वहाँ हर नतीजा दिखता है, और यह भी कि वह क्यों नहीं चुना गया।

डाउनलोडर और सोर्स देखें।

डाउनलोड हो गया पर इंपोर्ट नहीं हुआ

लक्षण: आपके डाउनलोडर में डाउनलोड पूरा हो गया, पर टाइटल आपकी लाइब्रेरी में नहीं है।

वजह: HolyArrs को फ़ाइल उसी पाथ पर नहीं दिखती, वह लाइब्रेरी फ़ोल्डर में लिख नहीं पाता, या इंपोर्ट को फ़ैसला चाहिए।

हल:

1. HolyArrs और डाउनलोडर को एक ही डाउनलोड फ़ोल्डर एक ही पाथ पर दें, जैसे /downloads, या डाउनलोडर पर Downloader’s path (डाउनलोडर का पाथ) और HolyArrs’ path (HolyArrs का पाथ) सेट करें।
2. doctor चलाएं और डाउनलोड या लाइब्रेरी फ़ोल्डर पर जो भी FAIL हो उसे ठीक करें।
3. डाउनलोड की सूची में Needs a decision (फ़ैसला चाहिए) वाले आइटम देखें, और प्लान को मंज़ूर या रद्द करें।

इंपोर्ट में कॉपी बनती है, हार्डलिंक नहीं

लक्षण: doctor कहता है कि हार्डलिंक काम नहीं करते, या इंपोर्ट के बाद डिस्क का इस्तेमाल दोगुना हो जाता है।

वजह: डाउनलोड और लाइब्रेरी फ़ोल्डर अलग-अलग डिस्क या माउंट पर हैं।

हल: अलग-अलग फ़ोल्डर की जगह एक साझा पैरेंट फ़ोल्डर कंटेनर में माउंट करें। फ़ोल्डर देखें।

HolyArrs शुरू नहीं होता

लक्षण: कंटेनर तुरंत बंद या रीस्टार्ट हो जाता है।

वजह: लॉग में वजह लिखी होती है। आम वजहें: /config किसी नेटवर्क शेयर या FUSE पाथ पर है, या कोई हिस्सा ख़राब है।

हल:

1. अगर लॉग ऐसा कहे तो /config को लोकल डिस्क पर ले जाएं। HolyArrs अपना डेटाबेस शेयर पर नहीं चलाता।
2. वरना सेफ़ मोड में शुरू करें, Settings से उसे ठीक करें, और फिर सामान्य तरीके से रीस्टार्ट करें।

कोई फ़ीचर नहीं दिख रहा

लक्षण: जिस फ़ीचर के बारे में आपने पढ़ा, वह ऐप में नहीं है।

वजह: हो सकता है वह इस वर्ज़न में रोका हुआ हो।

हल: रोके हुए फ़ीचर देखें।

पेजों पर नाम या तस्वीरें नहीं हैं

लक्षण: टाइटल बिना पोस्टर या जानकारी के दिखते हैं।

वजह: मेटाडेटा सर्वर तक पहुँच नहीं हो पा रही।

हल: अपना DNS और फ़ायरवॉल जाँचें। doctor का Network सेक्शन बताता है कि सर्वर जवाब दे रहा है या नहीं।

एक्सपर्ट के लिए

doctor की जाँचें और विकल्प

doctor कंटेनर के अंदर उसी यूज़र के तौर पर चलता है जिसके तौर पर HolyArrs चलता है, इसलिए उसे वही दिक्कतें मिलती हैं जो HolyArrs को मिलती हैं।

सेक्शन	क्या दिखाता है
App	वर्ज़न, यूज़र और ग्रुप, umask, और यह कि वह कंटेनर में चल रहा है या नहीं।
Config folder	मालिक, अनुमतियां, ख़ाली जगह, और यह कि वह लोकल डिस्क पर है या नहीं।
Library and download folders	मौजूद है या नहीं, मालिक, लिखा जा सकता है या नहीं, ख़ाली जगह, डाउनलोड और लाइब्रेरी फ़ोल्डर के बीच हार्डलिंक।
Network	मेटाडेटा सर्वर का नाम रिज़ॉल्व होता है या नहीं, और वह जवाब देता है या नहीं।
Clock	समय, टाइम ज़ोन (TZ), और घड़ी साफ़ तौर पर ग़लत होने पर चेतावनी।

विकल्प	यह क्या करता है
-config <folder>	/config की जगह HolyArrs का कोई दूसरा कॉन्फ़िग फ़ोल्डर जाँचता है।
-json	रिपोर्ट को JSON में प्रिंट करता है।

Exit code 0 का मतलब है कुछ फ़ेल नहीं हुआ; 1 का मतलब है किसी लाइन में FAIL है। रिपोर्ट में कुंजी, पासवर्ड या टोकन कभी नहीं दिखते। वह सिर्फ़ पढ़ता है; बस एक छोटी टेस्ट फ़ाइल लिखता है और हटा देता है। root के तौर पर शुरू करने पर वह कॉन्फ़िग फ़ोल्डर PUID:PGID को भी सौंप देता है, जैसा सामान्य शुरुआत में होता है।

अगर HolyArrs बार-बार रीस्टार्ट हो रहा है, तो docker exec फ़ेल हो जाता है। doctor को उन्हीं फ़ोल्डर के साथ एक नए कंटेनर में चलाएं:

docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> -e TZ=<tz> holyarrs/holyarrs:<tag> doctor

Compose के साथ: docker compose run --rm holyarrs doctor।

शुरू होते समय फ़ोल्डर की जाँच

शुरू होते समय HolyArrs अपने फ़ोल्डर जाँचता है और लॉग में एक सार वाली लाइन लिखता है, जैसे folders: 4 ok, 1 not writable, और फिर हर समस्या वाले फ़ोल्डर के लिए हल के साथ एक लाइन। जाँच 3 सेकंड बाद रुक जाती है, ताकि शुरुआत कभी अटके नहीं। जो फ़ोल्डर जवाब देने में बहुत धीमा हो, वह “जाँचा नहीं गया” गिना जाता है; अक्सर यह नींद से जागती डिस्क या धीमा नेटवर्क शेयर होता है। doctor उसे बिना समय सीमा के जाँचता है। लॉग देखें।

इमेज में शेल नहीं है

इमेज में सिर्फ़ HolyArrs प्रोग्राम है, इसलिए वह छोटी रहती है और हमलावर के लिए कम चीज़ें छोड़ती है। docker exec holyarrs sh जान-बूझकर फ़ेल होता है। क़रीब से देखने के लिए उसके बगल में एक अस्थायी मददगार कंटेनर शुरू करें:

docker run --rm -it --pid container:holyarrs --network container:holyarrs --volumes-from holyarrs busybox sh

उसे HolyArrs का प्रोसेस दिखता है, वह उसका नेटवर्क साझा करता है और उसके पास वही फ़ोल्डर उन्हीं पाथ पर होते हैं। वह root के तौर पर चलता है, इसलिए देखें पर बदलें नहीं: root के तौर पर लिखी फ़ाइल HolyArrs शायद पढ़ न पाए। HolyArrs के यूज़र के तौर पर टेस्ट करने के लिए --user <PUID>:<PGID> जोड़ें।

वर्ज़न पता करें

docker inspect --format '{{ index .Config.Labels "org.opencontainers.image.version" }}' holyarrs

doctor का App सेक्शन भी यही दिखाता है।

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

• मदद पाएं
• लॉग
• हेल्थ चेक