এনভায়রনমেন্ট ভেরিয়েবল

HolyArrs কন্টেইনার যতগুলো ভেরিয়েবল পড়ে, সব এখানে। বেশিরভাগ ইনস্টলে শুধু PUID, PGID আর TZ সেট করলেই চলে।

সাধারণ

ভেরিয়েবল	কী করে	ডিফল্ট	উদাহরণ
PUID, PGID	HolyArrs যে ইউজার ও গ্রুপ হিসেবে চলে। /config আর আপনার মিডিয়া ফোল্ডারগুলো এদের মালিকানায় থাকতে হবে।	1000, 1000	PUID=1000
TZ	সময়সূচি আর লগের টাইম জোন।	Etc/UTC	TZ=Europe/Amsterdam
UMASK	নতুন ফাইল থেকে যে পারমিশন বিট বাদ যায়। শুধু নতুন ফাইলে কাজ করে।	022	UMASK=002
HOLYARRS_SAVE_PATH	ডাউনলোডারের সেভ ফোল্ডার, ডাউনলোডার নিজে যে পাথে সেটি দেখে সেই পাথে। প্রতিটি ডাউনলোডের সাথে পাঠানো হয়।	নেই	/data/downloads
HOLYARRS_URL_BASE	রিভার্স প্রক্সির পেছনে একটি পাথের নিচে HolyArrs চালায়। / দিলে সেটিংসে সেভ করা পাথ উপেক্ষা করা হয়।	নেই	/holyarrs
HOLYARRS_ALLOWED_HOSTS	যেসব বাড়তি হোস্ট নাম দিয়ে মানুষ HolyArrs-এ ঢোকে, কমা দিয়ে আলাদা করে।	IP আর localhost	holyarrs.example.com
HOLYARRS_TRUSTED_PROXIES	আপনার রিভার্স প্রক্সির ঠিকানা বা নেটওয়ার্ক, কমা দিয়ে আলাদা করে। আসল ক্লায়েন্ট ঠিকানা পেতে এটা লাগে।	নেই	172.18.0.0/16
HOLYARRS_MASTER_KEY_FILE	ভল্টের মাস্টার কী আলাদা একটি ফাইল থেকে পড়ে। PUID ইউজারের ফাইলটি পড়ার পারমিশন থাকতে হবে।	/config/holyarrs.key	/keys/holyarrs.key

ফাইল থেকে মান

যেকোনো ভেরিয়েবলের নামের আগে FILE__ বসালে তার মান একটি ফাইল থেকে পড়া হয়, যেমন Docker secret থেকে।

environment:
  - FILE__HOLYARRS_ALLOWED_HOSTS=/run/secrets/holyarrs_hosts

ফাইলের শেষের একটি নতুন লাইন HolyArrs বাদ দেয়। ফাইলটি না পেলে HolyArrs থেমে যায়, আর লগে ভেরিয়েবল ও ফাইলের নাম থাকে, মান কখনো থাকে না।

রিকভারি ও সমস্যার সমাধান

ভেরিয়েবল	কী করে	ডিফল্ট	উদাহরণ
HOLYARRS_SAFE_MODE	শুধু মূল অংশ চালু করে: সাইন ইন, লাইব্রেরি, সেটিংস, ব্যাকআপ আর হেলথ। সমস্যা ঠিক হলে এটি সরিয়ে দিন।	বন্ধ	1
HOLYARRS_LOW_MEMORY	1 দিলে কম-মেমরি মোড জোর করে চালু হয়, 0 দিলে জোর করে বন্ধ। সেট না করলে প্রায় 2.5 GiB বা তার কম RAM থাকলে নিজে চালু হয়।	কম্পিউটারের আকার অনুযায়ী	1
HOLYARRS_FOLLOW_LINKS	1 দিলে লাইব্রেরি স্ক্যান আর ইমপোর্ট সিমলিংক হওয়া ভিডিও ও গানের ফাইল ব্যবহার করতে পারে (মাউন্ট করা ড্রাইভের লিংক দিয়ে বানানো লাইব্রেরির জন্য)। লিংক করা ডাউনলোড লাইব্রেরিতে লিংক হিসেবেই বসে।	বন্ধ	1
GOMEMLIMIT	HolyArrs নিজের জন্য যে মেমরি লক্ষ্য ঠিক করে, সেটি বদলায়।	HolyArrs ঠিক করে	1GiB
HOLYARRS_SKIP_SPACE_CHECK	ডেটাবেস আপডেটের আগের খালি জায়গা পরীক্ষা বাদ দেয়।	বন্ধ	yes
HOLYARRS_CONFIG_IN_MEMORY	মেমরিতে থাকা ফোল্ডারে /config রাখতে দেয়। টেস্টের মেশিনের জন্য; রিস্টার্টে ডেটা হারিয়ে যায়।	বন্ধ	yes
HOLYARRS_ALLOW_DESKTOP_FOLDER	Mac-এ Docker Desktop-এর শেয়ার করা ফোল্ডারে /config রেখে চালু হয়, সেখানে ফাইল লক কাজ করে কি না আপনি দেখে নেওয়ার পর। প্রতিবার চালুর সময় HolyArrs সতর্ক করে।	বন্ধ	1
HOLYARRS_READONLY_DOWNLOADERS	যেসব ডাউনলোডার HolyArrs কখনো বদলাবে না, আইডি বা ঠিকানা দিয়ে, কমা দিয়ে আলাদা করে।	নেই	3,http://qbit:8080
HOLYARRS_HEALTH_URL	কন্টেইনারের হেলথ চেক যে ঠিকানায় ডাকে।	http://127.0.0.1:6262	http://127.0.0.1:6262/holyarrs

চালু/বন্ধের ভেরিয়েবলগুলো 1, true, yes বা on নেয়।

সিঙ্গেল সাইন-অন

চালুর আগে এগুলো সেট করুন। HOLYARRS_OIDC_ENABLED একেবারে থাকলেই, false হলেও, সিঙ্গেল সাইন-অন এনভায়রনমেন্টের হাতে থাকে আর সেটিংস শুধু সেটা দেখায়। এখানকার চালু/বন্ধের ভেরিয়েবলগুলো শুধু true বা false নেয়; অন্য কিছু দিলে HolyArrs চালুই হয় না।

ভেরিয়েবল	কী করে	ডিফল্ট
HOLYARRS_OIDC_ENABLED	সিঙ্গেল সাইন-অন চালু করে।	false
HOLYARRS_OIDC_ISSUER	প্রোভাইডারের হুবহু HTTPS issuer।	নেই
HOLYARRS_OIDC_CLIENT_ID	রেজিস্টার করা ক্লায়েন্ট আইডি।	নেই
HOLYARRS_OIDC_CLIENT_SECRET_FILE	ক্লায়েন্ট সিক্রেট রাখা ফাইল, সর্বোচ্চ 4096 বাইট। পাবলিক ক্লায়েন্ট হলে বাদ দিন।	নেই
HOLYARRS_OIDC_REDIRECT_URL	হুবহু কলব্যাক: আপনার ঠিকানা, থাকলে URL base, তারপর /api/v1/auth/oidc/callback।	নেই
HOLYARRS_OIDC_ALLOW_JOIN	নতুন মানুষ সদস্য হিসেবে যোগ দেয়, যারা শুধু অনুরোধ করতে পারে।	false
HOLYARRS_OIDC_ALLOW_LOCAL_NETWORK	আপনার ব্যক্তিগত নেটওয়ার্কের একটি প্রোভাইডার অনুমতি দেয়।	false
HOLYARRS_OIDC_ALLOW_LOOPBACK_HTTP	টেস্টের জন্য এই কম্পিউটারে সাধারণ HTTP অনুমতি দেয়।	false
HOLYARRS_FORWARD_AUTH_ENABLED	বিশ্বস্ত প্রক্সির মাধ্যমে সাইন ইন চালু করে।	false
HOLYARRS_FORWARD_AUTH_ISSUER	প্রক্সির জন্য স্থির HTTPS নাম।	নেই
HOLYARRS_FORWARD_AUTH_TRUSTED_PEERS	যেসব প্রক্সি ঠিকানা বা রেঞ্জ পরিচয়ের হেডার পাঠাতে পারে, কমা দিয়ে আলাদা করে।	নেই
HOLYARRS_FORWARD_AUTH_ALLOW_JOIN	নতুন প্রক্সি নামের মানুষ সদস্য হিসেবে যোগ দেয়, যারা শুধু অনুরোধ করতে পারে।	false

ভুল সেটআপ থাকলে HolyArrs চালুই হয় না। ধাপগুলো সাইন ইন ও পাসওয়ার্ড পেজে আছে।

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

মেটাডেটা

ভেরিয়েবল	কী করে	ডিফল্ট
HOLYARRS_METADATA_URL	মেটাডেটা সার্ভারের ঠিকানা।	https://api.holyarrs.com
HOLYARRS_TMDB_KEY	আপনার নিজের TMDB read access token। সেট করলে TMDB-র তথ্য মেটাডেটা সার্ভার ছাড়াই সরাসরি TMDB থেকে আসে।	নেই
HOLYARRS_METADATA_SERVICE_TOKEN_FILE	এই ইনস্টলের মেটাডেটা সার্ভার ক্রেডেনশিয়াল রাখা ফাইল, প্রতিটি কলে পড়া হয়। সেট না করলে ক্রেডেনশিয়াল ভল্টে থাকে।	নেই

নিজের TMDB কী থাকলেও কী কী মেটাডেটা সার্ভারের মধ্য দিয়েই যায়, আর বাকি প্রতিটি বাইরের ঠিকানা, বাইরের ঠিকানা-য় আছে।

প্রথম চালুর শর্টকাট

প্রতিটি চালুর সময় একটি করে জিনিস যোগ করে। ডেমো আর টেস্টের জন্য; প্রথমবার চালু করার উইজার্ডও একই কাজ করে।

ভেরিয়েবল	যোগ করে
HOLYARRS_MOVIES	একটি মুভি লাইব্রেরি ফোল্ডার।
HOLYARRS_QBITTORRENT_URL	একটি qBittorrent ডাউনলোডার।
HOLYARRS_SOURCE_URL	কী ছাড়া একটি Torznab সোর্স।

ডেভেলপার ও টেস্টের ভেরিয়েবল

টেস্টের সময় HolyArrs-কে নকল সার্ভিসের ঠিকানা দেওয়ার জন্য এগুলো। আসল ইনস্টলে সেট করবেন না।

ভেরিয়েবল	কী করে
HOLYARRS_FLAGS	এই ভার্সনে ডিফল্টে বন্ধ থাকা ফিচারগুলোর সুইচ, কমা দিয়ে আলাদা করে। দেখুন আপডেট।
HOLYARRS_DIRECT_SOURCES	1 দিলে এই ইনস্টল মেটাডেটা সার্ভারের বদলে নিজেই গান ও টিভির সোর্সকে জিজ্ঞেস করতে পারে।
HOLYARRS_METADATA_SERVICE_ALLOW_LOCAL	লোকাল নেটওয়ার্কের একটি মেটাডেটা সার্ভার অনুমতি দেয়।
HOLYARRS_METADATA_COUNT	মেটাডেটা অনুরোধ গুনে লগ করে।
HOLYARRS_TMDB_TOKEN_FILE, HOLYARRS_TMDB_URL	টেস্টের TMDB token ফাইল আর নকল ঠিকানা।
HOLYARRS_TVMAZE_URL, HOLYARRS_MUSICBRAINZ_URL, HOLYARRS_DEEZER_URL, HOLYARRS_TRAKT_URL, HOLYARRS_PLEX_URL, HOLYARRS_PLEX_APP_URL, HOLYARRS_PLEX_DISCOVER_URL, HOLYARRS_PUSHOVER_URL, HOLYARRS_TELEGRAM_URL, HOLYARRS_YOUTUBE_URL, HOLYARRS_RELEASE_FEED	বাইরের সার্ভিসের নকল ঠিকানা।
HOLYARRS_TRAILER_PASS_FIRST, HOLYARRS_TRAILER_PASS_EVERY	ট্রেলার পাসের সময়, 2s-এর মতো সময়কাল হিসেবে।

সংশ্লিষ্ট

• ইনস্টল
• একটি পাথের নিচে চালান
• সাইন ইন ও পাসওয়ার্ড