আপডেট

নতুন ভার্সন এলে HolyArrs আপনাকে জানায়, কিন্তু নিজে কখনো ইনস্টল করে না। সুবিধামতো সময়ে আপনি নতুন ইমেজ পুল করেন।

নতুন ভার্সন এসেছে কি না দেখুন

1. Status (স্ট্যাটাস) পেজ খুলুন (http://your-server:6262/health)।
2. Updates (আপডেট) অংশটি পড়ুন। আপনি এগুলোর একটি দেখতে পাবেন:

বার্তা	মানে
“HolyArrs 1.2.0 is out, newer than this one.”	সুবিধামতো সময়ে আপডেট করুন
“This is the newest version.”	কিছু করার নেই
“No HolyArrs release is published yet.”	ফিড খালি। কোনো সমস্যা নেই
“The last check did not work: …”	ফিডে পৌঁছানো যায়নি, প্রায়ই ইন্টারনেট নেই বলে
“The update check is off: …”	সেটিংসে বন্ধ করা আছে

3. এখনই জানতে চাইলে Check now (এখনই চেক করুন) বা Check again (আবার চেক করুন) বেছে নিন। এর জন্য Change settings (সেটিংস বদলানো) পারমিশন লাগে।

নতুন ভার্সন হেলথ সতর্কতা হিসেবেও দেখা যায়। ব্যর্থ চেক শুধু Updates-এর নিচে দেখা যায়।

আপডেট করুন

1. নতুন ইমেজ পুল করে রিস্টার্ট করুন: docker compose pull, তারপর docker compose up -d।
2. HolyArrs চালু হয়। নতুন ভার্সন ডেটা রাখার ধরন বদলালে সে আগে ব্যাকআপ নেয়, তারপর ডেটা আপডেট করে। আপনি অ্যাপটি নতুন ভার্সনে খুলতে দেখতে পাবেন।

Tip

আপডেটের কোনো ধাপ ব্যর্থ হলে তা ফিরিয়ে নেওয়া হয় আর HolyArrs একটি পেজে থেমে যায় যেখানে কী হয়েছে লেখা থাকে। আপডেটের আগের ডেটা ব্যাকআপ হিসেবে থেকে যায়।

আগের ভার্সনে ফিরে যান

HolyArrs নিজের ইমেজ বদলাতে পারে না, তাই আপনি আগের ইমেজ চালান আর HolyArrs আগের ডেটা ফিরিয়ে আনে।

Caution

আপডেটের পরে যা বদলেছে, যেমন নতুন টাইটেল, সেটিংস ও হিস্ট্রি, তা আপডেটের আগের ব্যাকআপে নেই।

1. আপনার compose ফাইলে (বা docker run-এ) ইমেজ ট্যাগ বদলে আগেরটি দিন, যেমন holyarrs/holyarrs:<older version>।
2. docker compose up -d চালান।
3. আপডেট ডেটা না বদলে থাকলে আগের ভার্সন চালু হয়। আপনার কাজ শেষ।
4. না হলে আগের ভার্সন অ্যাপের বদলে একটি পেজ দেখায়। Put back the data from before the update (আপডেটের আগের ডেটা ফিরিয়ে আনুন) বেছে নিন।
5. একবার ব্যবহারের কোডটি লিখুন। কোডটি পাবেন docker logs <container> দিয়ে; “one-time code” খুঁজুন।
6. HolyArrs ব্যাকআপ যাচাই করে, জায়গামতো বসায় আর বন্ধ হয়ে যায়। আপনি দেখতে পাবেন কন্টেইনারটি তার রিস্টার্ট পলিসির মাধ্যমে ওই ডেটা নিয়ে আবার চালু হচ্ছে। রিস্টার্ট পলিসি না থাকলে নিজে চালু করুন।

পেজ ছাড়া: docker exec <container> /holyarrs restore --pre-update, তারপর docker restart <container>। Docker ছাড়া: HolyArrs বন্ধ করুন, holyarrs restore --pre-update চালান, তারপর চালু করুন।

কিছু মুছে যায় না। নতুন ডেটা backups/before-restore-<time>/-এ সরে যায়, তাই আপনি পাল্টাতে পারেন। একের বেশি ভার্সন পিছিয়ে গেলে ওই ভার্সন যে সবচেয়ে নতুন আপডেট-পূর্ব ব্যাকআপ পড়তে পারে, সেটি বেছে নেওয়া হয়।

বিকল্প

সবই Settings > Health checks (সেটিংস > হেলথ চেক)-এ। শেষ তিনটি কার্ডের অ্যাডভান্সড অংশে আছে।

সেটিং	ডিফল্ট	কখন বদলাবেন
Check for a newer HolyArrs (HolyArrs-এর নতুন ভার্সন খুঁজুন)	On	বাইরে কোনো রিকোয়েস্টই চান না
Check for updates every (কতদিন পরপর আপডেট খুঁজবেন)	day	কম চেক চান: 3, 7, 14 বা 30 দিন
Release feed (রিলিজ ফিড)	Empty (HolyArrs releases)	আপনি নিজের ফিড হোস্ট করেন
Feed may be on the local network (ফিড লোকাল নেটওয়ার্কে থাকতে পারে)	Off	আপনার ফিড আপনার নিজের নেটওয়ার্কে
Include test versions (like 1.2.0-rc1) (টেস্ট ভার্সনও ধরুন, যেমন 1.2.0-rc1)	Off	টেস্ট ভার্সনের নোটিসও চান

কাজ না করলে

লক্ষণ: “The last check did not work.” কারণ: সার্ভারে ইন্টারনেট নেই, অথবা আপনার নিজের ফিড লোকাল নেটওয়ার্কে। সমাধান: ইন্টারনেট সংযোগ দেখুন, অথবা Feed may be on the local network চালু করুন।

লক্ষণ: রিলিজ ফিড সেভ হচ্ছে না। কারণ: ঠিকানায় ইউজারনেম, পাসওয়ার্ড, ?query বা #fragment আছে, অথবা এটি http:// বা https:// দিয়ে শুরু হয়নি। সমাধান: ওই অংশগুলো সরিয়ে দিন।

লক্ষণ: ডিস্কে জায়গা না থাকায় আপডেট থেমে গেছে। কারণ: কপি আর আপডেটের জন্য জায়গা নেই। সমাধান: কনফিগ ফোল্ডার যে ডিস্কে আছে সেখানে জায়গা খালি করুন, তারপর আবার শুরু করুন।

লক্ষণ: ফিরে যাওয়ার পেজ আপনার কোড নিচ্ছে না। কারণ: কোডটি পুরোনো, অথবা শেষবার চালু হওয়ার পর 10 বার ভুল কোড দেওয়া হয়েছে। সমাধান: সবচেয়ে নতুন লগ লাইন থেকে কোডটি কপি করুন। 10 বার ভুল হলে কন্টেইনার রিস্টার্ট করে নতুন কোড ব্যবহার করুন।

আটকে রাখা ফিচার

এই ভার্সনে কিছু ফিচার ডিফল্টভাবে বন্ধ। নিজের ঝুঁকিতে চালু করুন। আটকে থাকা অবস্থায় এগুলোর পেজ ও মেনু আইটেম লুকানো থাকে, API রুট “not found” উত্তর দেয় আর কাজগুলো চলে না। এগুলোর জন্য সেভ করা ডেটা থেকে যায়।

একটি চালু করতে এর সুইচ HOLYARRS_FLAGS-এ কমা দিয়ে যোগ করুন আর কন্টেইনার রিস্টার্ট করুন:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

বন্ধ করতে নামটি সরিয়ে রিস্টার্ট করুন। আবার চালু করলে লুকানো সেটিংস ফিরে আসে।

সুইচ	ফিচার
row_title_stats	Appearance-এ এক্সপ্লোর সারির টাইটেল পরিসংখ্যান
trakt_lists	Trakt কী, Trakt লিস্ট ও Trakt রিভিউ। TMDB লিস্ট চালু থাকে
alert_channels_more	Telegram, ntfy, Gotify, Pushover ও webhook অ্যালার্ট। Discord ও ইমেইল চালু থাকে
subtitle_sites	সাবটাইটেল সাইট ও সাবটাইটেল সার্চ। আপনার সাবটাইটেল ভাষা চালু থাকে
emby_signin	Emby দিয়ে সাইন ইন। Emby লাইব্রেরি রিফ্রেশ তবু কাজ করে
go_back	স্ট্যাটাস পেজের Go back (আগের ভার্সনে ফিরুন) প্যানেল। আগের ভার্সনে ফিরে যান-এর ধাপগুলো এটি ছাড়াই কাজ করে

সুইচ যোগ করার পরও কিছু বদলায়নি? বানান দেখুন (ছোট হাতের অক্ষর, আন্ডারস্কোর) আর শুধু পেজ নয়, কন্টেইনার রিস্টার্ট করুন।

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

চেকটি কী পাঠায়

সবচেয়ে নতুন রিলিজের জন্য api.github.com-এ একটি রিকোয়েস্ট, শুধু User-Agent: HolyArrs/<version> সহ। কোনো অ্যাকাউন্ট, কী বা মিডিয়া তালিকা নয়। চেক বন্ধ থাকলে কোনো রিকোয়েস্টই যায় না।

শেষ উত্তরটি সেভ করা থাকে, তাই রিস্টার্টে সময় হওয়ার আগে চেক হয় না। একটি চেক সর্বোচ্চ 15 s অপেক্ষা করে, সর্বোচ্চ 512 KB পড়ে আর সর্বোচ্চ 3টি রিডাইরেক্ট অনুসরণ করে, কখনো http আর https-এর মধ্যে বদলায় না। রিলিজ নোটের লিংক শুধু তখনই দেখা যায় যখন তা GitHub-এ HolyArrs রিলিজ পেজের দিকে যায়; না হলে ভার্সনটি সাধারণ লেখা হিসেবে দেখায়।

Release feed একটি GitHub-ধাঁচের রিলিজ উত্তর, রিলিজের তালিকা, version আছে এমন যেকোনো JSON, অথবা ভার্সন লেখা সাধারণ টেক্সট নেয়। ক্লাউড মেটাডেটা ঠিকানা সবসময় আটকে দেওয়া হয়। টেস্ট ভার্সন সাধারণ ভার্সনের চেয়ে পুরোনো ধরা হয়।

আপডেটের আগের ব্যাকআপ

সংরক্ষিত ডেটা বদলানোর আগে HolyArrs:

1. দেখে কপি আর আপডেটের জন্য জায়গা আছে কি না। না থাকলে কিছুই বদলায় না। বাদ দিতে HOLYARRS_SKIP_SPACE_CHECK=yes দিন।
2. প্রতিটি ডেটাবেস backups-এ কপি করে, কপি যাচাই করে আর পাশে একটি sha256 ফাইল লেখে। 3 বার কপি ব্যর্থ হলে কিছুই বদলায় না।
3. প্রতিটি আপডেট ধাপ আলাদাভাবে চালায় ও যাচাই করে। ব্যর্থ ধাপ ফিরিয়ে নেওয়া হয়; শেষ হওয়া ধাপ থেকে যায়। একই ভার্সন আবার চালু করলে একই কপি নিয়ে ব্যর্থ ধাপ থেকে কাজ চলে।

প্রথমবার ঠিকভাবে চালু হওয়ার পর কপিটি holyarrs-backup-pre-update-<time>.zip হয়ে যায়, আর বর্ণনা থাকে যেমন “before updating from 1.1.0 to 1.2.0”। এটি Settings > Backups আর holyarrs restore --list-এ দেখা যায়। সবচেয়ে নতুন 3টি রাখা হয়; ব্যাকআপ সময়সূচি এগুলো কখনো মোছে না। নতুন ইনস্টল, বা ডেটা না বদলানো আপডেটে কোনোটি তৈরি হয় না।

ইমেজ যাচাই করুন

1.0.3 থেকে Docker Hub-এর প্রতিটি ইমেজ GitHub-এর রিলিজ রান দিয়ে সাইন করা। ডাউনলোড করার মতো কোনো কী নেই। cosign দিয়ে ইমেজ যাচাই করুন। আপনি যে ভার্সন চালান, যেমন 1.0.3, সেটি <version>-এর জায়গায় বসান:

cosign verify holyarrs/holyarrs:<version> \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --certificate-identity-regexp '^https://github.com/HolyArrs/HolyArrs/\.github/workflows/sign\.yml@refs/(tags/[0-9.]+|heads/main)$'

আপনি The cosign claims were validated দেখতে পাবেন। অন্য কিছু মানে ইমেজটি HolyArrs-এর রিলিজ রান থেকে আসেনি: চালাবেন না।

ইমেজের সঙ্গে এটি কীভাবে তৈরি হয়েছে তার একটি রেকর্ড আর ভেতরে কী আছে তার তালিকা (SBOM) থাকে। GitHub CLI দিয়ে সেগুলো যাচাই করুন:

gh attestation verify oci://docker.io/holyarrs/holyarrs:<version> --repo HolyArrs/HolyArrs

একই ফাইলগুলো প্রতিটি GitHub রিলিজে আছে: .sigstore.json (সিগনেচার), .intoto.jsonl (বিল্ড রেকর্ড) আর .sbom.spdx.json (ভেতরের তালিকা)।

সংশ্লিষ্ট

• ব্যাকআপ
• হেলথ চেক
• অংশ ও সেফ মোড