फ़ाइल से कुंजियाँ इंपोर्ट करें

एक फ़ाइल में अपने सोर्स, डाउनलोडर, मीडिया सर्वर, सबटाइटल साइट और मेल की जानकारी भरें, उसे इंपोर्ट करें, और सेटिंग में हर कुंजी टाइप करने से बचें।

शुरू करने से पहले

• HolyArrs Docker में चलता है और उसका कॉन्फ़िग /config पर है।
• आप Settings > API > API keys (सेटिंग > API > API कुंजियाँ) में ओनर API कुंजी बना सकते हैं।

फ़ाइल इंपोर्ट करें

1. holyarrs-secrets.template.yaml को holyarrs-secrets.yaml नाम से कॉपी करें।

2. जो आप इस्तेमाल करते हैं वह भरें। बाक़ी ख़ाली छोड़ें; ख़ाली का मतलब है छोड़ दो।

3. इसे ऐसा बनाएं कि सिर्फ़ आप पढ़ सकें:

   chmod 600 holyarrs-secrets.yaml

4. इसे कंटेनर में सिर्फ़ पढ़ने के लिए माउंट करें:

   volumes:
     - /srv/holyarrs/config:/config
     - /srv/holyarrs/holyarrs-secrets.yaml:/run/secrets/holyarrs.yaml:ro

5. Settings > API > API keys में admin स्कोप वाली ओनर API कुंजी बनाएं। इसे फ़ाइल के holyarrs ब्लॉक में एड्रेस http://127.0.0.1:6262 के साथ रखें।

6. पहले ड्राई रन आज़माएं। इससे कुछ नहीं बदलता:

   docker exec holyarrs /holyarrs import-secrets -file /run/secrets/holyarrs.yaml -dry-run

   हर आइटम के लिए एक would set लाइन दिखनी चाहिए।

7. अब इसे असल में चलाएं (वही कमांड, -dry-run के बिना)। set लाइनें और एग्ज़िट कोड 0 दिखना चाहिए।

8. नए सोर्स और डाउनलोडर जाँचें, फिर उन्हें फिर शुरू करें। नए मीडिया सर्वर और अलर्ट टेस्ट करें, फिर उन्हें चालू करें।

9. होस्ट पर फ़ाइल हटाएं (फ़ाइल हटाएं देखें)। अगर API कुंजी की अब ज़रूरत नहीं, तो उसे भी हटाएं।

सावधानी

जब तक आप फ़ाइल नहीं हटाते, उसमें हर सीक्रेट सादे टेक्स्ट में रहता है। रन सफल होते ही इसे होस्ट पर हटा दें।

हर ब्लॉक क्या बनता है

फ़ाइल में	क्या बनता है
trakt.client_id	Trakt ऐप की कुंजी (Settings > Outside lists (सेटिंग > बाहरी सूचियाँ))।
tmdb, tvdb	पुरानी फ़ाइलों से स्वीकार किए जाते हैं। मेटाडेटा को कुंजियों की ज़रूरत नहीं।
opensubtitles, subdl	आपके अकाउंट वाली एक सबटाइटल साइट।
addic7ed	एक Addic7ed सबटाइटल साइट, सिर्फ़ शो के लिए।
indexers	हर एंट्री के लिए एक सोर्स, paused (रुका हुआ)।
jackett, prowlarr	इनकी कुंजी उसी एड्रेस की हर उस indexers एंट्री में भर जाती है जिसमें कुंजी नहीं है।
qbittorrent, sabnzbd	एक डाउनलोडर, paused।
nzbget, transmission, deluge	छोड़ दिए जाते हैं। इंपोर्ट इन्हें अभी सेट नहीं कर सकता; इन्हें Settings > Downloaders (सेटिंग > डाउनलोडर) में जोड़ें।
jellyfin, emby, plex	एक मीडिया सर्वर, जब तक आप टेस्ट न करें तब तक off (बंद)।
smtp, discord, webhook	“Email”, “Discord” और “Webhook” अलर्ट, जब तक आप टेस्ट न करें तब तक off।
radarr, sonarr, lidarr, prowlarr, bazarr, seerr	Move from other apps (दूसरे ऐप से आना) के लिए सेव की गई कुंजी।
holyarrs	सिर्फ़ चलते हुए HolyArrs तक पहुँचने के लिए इस्तेमाल होता है। कभी सेव नहीं होता।

हर कुंजी एन्क्रिप्टेड वॉल्ट में जाती है, ठीक वैसे जैसे सेटिंग में टाइप की गई कुंजी।

विकल्प

लोकल नेटवर्क का स्विच

एड्रेस वाला हर ब्लॉक allow_local_network: true ले सकता है। इससे वह आइटम इस मशीन या आपके घर के नेटवर्क (192.168.x.x, 10.x.x.x, किसी कंटेनर का नाम) तक पहुँच सकता है। इसके बिना आइटम सिर्फ़ इंटरनेट तक पहुँचता है, इसलिए घर पर चलने वाला डाउनलोडर जवाब नहीं देगा। HolyArrs एड्रेस देखकर इसका अंदाज़ा कभी नहीं लगाता। यह वही स्विच है जो सेटिंग में May reach the local network (लोकल नेटवर्क तक पहुँच सकता है) है।

HolyArrs बंद होने पर

उसी कॉन्फ़िग पर एक बार चलने वाला कंटेनर चलाएं। यह सीधे कॉन्फ़िग फ़ोल्डर में सेव करता है और इसे holyarrs ब्लॉक नहीं चाहिए:

docker stop holyarrs
docker run --rm -e PUID=1000 -e PGID=1000 \
  -v /srv/holyarrs/config:/config \
  -v /srv/holyarrs/holyarrs-secrets.yaml:/run/secrets/holyarrs.yaml:ro \
  holyarrs/holyarrs:latest import-secrets -file /run/secrets/holyarrs.yaml
docker start holyarrs

ऐप वाले ही PUID और PGID इस्तेमाल करें, नहीं तो कॉन्फ़िग फ़ोल्डर 1000:1000 के नाम हो जाता है। PUID वाला यूज़र फ़ाइल पढ़ सकता हो, यह ज़रूरी है। अगर आप HOLYARRS_MASTER_KEY_FILE इस्तेमाल करते हैं, तो एक बार चलने वाले कंटेनर को भी वही वेरिएबल और माउंट दें।

इसे दोबारा चलाना

इसे दोबारा चलाना सुरक्षित है। जो आइटम मेल खाते हैं वे unchanged कहते हैं; सिर्फ़ बदले हुए आइटम सेव होते हैं।

आइटम	किससे मिलाया जाता है
सोर्स	नाम
डाउनलोडर, मीडिया सर्वर	किस्म और एड्रेस
अलर्ट	नाम और किस्म
सबटाइटल साइट, पुराने ऐप	किस्म

जिस सोर्स या डाउनलोडर का एड्रेस या कुंजी बदली है, वह फिर से रोक दिया जाता है। एक बार आप उसे ख़ुद फिर शुरू कर दें, तो दोबारा रन उसे चलता रहने देता है। indexers एंट्री में ख़ाली api_key सेव की हुई कुंजी रखता है; उसे हटाने के लिए clear_key: true जोड़ें।

फ़ाइल हटाएं

-delete के साथ कमांड फ़ाइल के ऊपर ज़ीरो लिखती है और उसे हटा देती है, सिर्फ़ उस रन के बाद जिसमें कुछ फ़ेल नहीं हुआ। सिर्फ़ पढ़ने के लिए किया गया माउंट कंटेनर के अंदर से नहीं हटाया जा सकता, इसलिए इसे होस्ट पर हटाएं:

सिस्टम	कमांड
Linux	shred -u holyarrs-secrets.yaml
macOS	rm -P holyarrs-secrets.yaml
Windows	Remove-Item holyarrs-secrets.yaml, फिर Recycle Bin ख़ाली करें।

SSD और copy-on-write फ़ाइल सिस्टम पर पुराने ब्लॉक डिस्क पर रह सकते हैं। कुंजियाँ ख़ुद अब एन्क्रिप्टेड वॉल्ट में रहती हैं।

अगर काम न करे

लक्षण	वजह	हल
फ़ाइल दूसरे यूज़र भी पढ़ सकते हैं	अनुमतियाँ बहुत खुली हैं।	chmod 600 चलाएं। Windows पर इसे ऐसे फ़ोल्डर में रखें जिसे सिर्फ़ आप खोल सकें।
किसी अनजान कुंजी ने इंपोर्ट रोक दिया	बताई गई लाइन में टाइपो या टैब है।	वह लाइन ठीक करें। कुछ भी सेव नहीं हुआ।
सादा http मना कर दिया गया	holyarrs एड्रेस इस मशीन का नहीं है।	कंटेनर के अंदर http://127.0.0.1:6262 के साथ चलाएं, या https इस्तेमाल करें।
घर पर चलने वाला डाउनलोडर जवाब नहीं देता	लोकल नेटवर्क की अनुमति नहीं है।	उस ब्लॉक पर allow_local_network: true सेट करें।
एक बार चलने वाले कंटेनर ने फ़ोल्डर के मालिक बदल दिए	अलग PUID/PGID।	ऐप वाले PUID और PGID इस्तेमाल करें।
-delete ने कुछ नहीं किया	कुछ फ़ेल हुआ, या माउंट सिर्फ़ पढ़ने के लिए है।	इसे होस्ट पर हटाएं।

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

फ़्लैग और एग्ज़िट कोड

फ़्लैग	यह क्या करता है	डिफ़ॉल्ट
-file <path>	सीक्रेट वाली फ़ाइल।	कोई नहीं
-dry-run	सिर्फ़ बताता है कि क्या सेट होता।	बंद
-config <folder>	कॉन्फ़िग फ़ोल्डर।	/config
-delete	बिना किसी फ़ेल वाले रन के बाद फ़ाइल के ऊपर ज़ीरो लिखकर उसे हटाता है।	बंद
-forget-move-credentials	पुराने ऐप की हर सेव की हुई कुंजी हटाता है, फिर रुक जाता है।	बंद
-allow-http-lan	घर के नेटवर्क के एड्रेस पर सादा http:// चलने देता है। चेतावनी छापता है।	बंद
-allow-readable-file	ऐसी फ़ाइल स्वीकार करता है जिसे दूसरे यूज़र पढ़ सकते हैं। Windows पर Docker Desktop हर फ़ाइल को पढ़ने लायक दिखाता है।	बंद

holyarrs एड्रेस https:// होना चाहिए, या सादा http:// सिर्फ़ इसी मशीन के लिए (127.0.0.1, ::1, localhost)। सादे http पर आपकी ओनर कुंजी और पूरी फ़ाइल बिना एन्क्रिप्शन के जाती है।

एग्ज़िट कोड	मतलब
0	हर आइटम ठीक रहा।
1	कोई आइटम फ़ेल हुआ। फ़ाइल ठीक करें और दोबारा चलाएं।
2	कमांड लाइन या फ़ाइल ग़लत है।

आउटपुट

हर आइटम के लिए एक लाइन: set (या ड्राई रन में would set, कभी-कभी एक नोट के साथ), unchanged, skipped (empty), skipped (why) या failed: why। यह कभी कोई कुंजी, पासवर्ड, टोकन या एड्रेस नहीं छापता। हिस्ट्री में सिर्फ़ गिनतियों वाला एक इवेंट जुड़ता है। जो एरर आपकी फ़ाइल की कोई वैल्यू दिखाता, वह उसकी जगह [hidden] दिखाता है।

फ़ाइल का फ़ॉर्मेट

YAML का एक छोटा, सख़्त हिस्सा:

• ब्लॉक स्पेस के इंडेंट से बनते हैं, टैब से कभी नहीं; सूचियाँ - से,
• वैल्यू सादी, "double quotes" में या 'single quotes' में (सिंगल कोट के अंदर ' को दो बार लिखें),
• # लाइन की शुरुआत में या कोट के बाहर स्पेस के बाद कमेंट शुरू करता है, इसलिए जिस पासवर्ड में # हो उसे कोट में रखें,
• जो वैल्यू &, *, !, |, >, [, {, %, @ या बैककोट से शुरू हो, या जिसमें : हो, उसे कोट में रखें।

कोई अनजान कुंजी या 256 KB से बड़ी फ़ाइल कुछ भी सेव होने से पहले पूरा इंपोर्ट रोक देती है; संदेश में कुंजी और लाइन का नाम होता है। फ़ाइल की तरफ़ जाने वाला लिंक मना कर दिया जाता है।

ख़ास फ़ील्ड

फ़ील्ड	नियम
SABnzbd	पूरा api_key चाहिए। nzb_key, यूज़रनेम या पासवर्ड छोड़ दिया जाता है और कभी सेव नहीं होता।
tvdb.api_key, tvdb.unique_user_key, trakt.redirect_urls	स्वीकार किए जाते हैं और छोड़ दिए जाते हैं।
smtp.host	सिर्फ़ सर्वर का नाम, स्कीम या पोर्ट नहीं।
smtp.port	1 से 65535। डिफ़ॉल्ट 587।
smtp.from	एक सादा ईमेल एड्रेस।
पुराने ऐप के ब्लॉक	Move from other apps में Use the saved key (सेव की हुई कुंजी इस्तेमाल करें) के साथ इस्तेमाल होते हैं। कभी दिखाए नहीं जाते, सिर्फ़ ओनर के लिए, एक सफल रीड के बाद हटा दिए जाते हैं।

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

• अपने पुराने ऐप पढ़ें
• एनवायरनमेंट वेरिएबल