ব্যাকআপ

আপনার সেটআপের একটি কপি রাখুন, যাতে খারাপ আপডেট, ডিস্ক নষ্ট হওয়া বা নতুন কম্পিউটারে যাওয়ার পরে সেটি ফিরিয়ে আনতে পারেন।

শুরু করার আগে

• Settings > Backups (সেটিংস > ব্যাকআপ) খুলতে Change settings (সেটিং বদলানো) পারমিশন লাগে। রিস্টোর শুধু মালিক করতে পারেন।
• ডাউনলোড, মুছে ফেলা আর রিস্টোরের জন্য কয়েক মিনিট আগে পাসওয়ার্ড দিয়ে সাইন ইন করা থাকতে হবে।

ব্যাকআপ নিন

1. Settings > Backups খুলুন।
2. Back up now (এখনই ব্যাকআপ নিন) চাপুন। Saved backups (সেভ করা ব্যাকআপ) এর নিচে নতুন ব্যাকআপটি দেখতে পাবেন।
3. সার্ভারের বাইরে একটি কপি রাখতে ওটার পাশের Download (ডাউনলোড) চাপুন।

মাস্টার কী সেভ করুন

ব্যাকআপে মাস্টার কী থাকে না। এই কী দিয়েই আপনার সেটিংসের পাসওয়ার্ড আর API কী খোলা যায়। মিল থাকা কী ছাড়া রিস্টোর করা ব্যাকআপ সেগুলো পড়তে পারে না।

1. Master key (মাস্টার কী) এর নিচে মালিক Download key kit (কী কিট ডাউনলোড) চাপেন।
2. ফাইলটি সার্ভার থেকে আলাদা জায়গায় আর ব্যাকআপ থেকেও আলাদা রাখুন। তখন Settings > Backups আর হেলথ চেক থেকে কী কিটের সতর্কতাটি সরে যেতে দেখবেন।

পরে ব্যবহার করতে ফাইলটির নাম বদলে holyarrs.key করে কনফিগ ফোল্ডারে রাখুন। আপনি মালিক না হলে মালিককে ডাউনলোড করতে বলুন।

ব্যাকআপ রিস্টোর করুন

Danger

ব্যাকআপের পরে যা বদলেছে তা হারিয়ে যাবে। আগে মিল থাকা মাস্টার কী হাতের কাছে রাখুন।

1. Restore from a file (ফাইল থেকে রিস্টোর) চাপুন আর HolyArrs-এর একটি ব্যাকআপ zip বেছে নিন।
2. নিশ্চিত করুন।
3. HolyArrs ফাইলটি যাচাই করে। আপনি Restore ready. It applies on the next start. (রিস্টোর তৈরি। পরের বার চালু হলে প্রয়োগ হবে।) দেখতে পাবেন।
4. HolyArrs রিস্টার্ট হয় আর ব্যাকআপটি জায়গামতো বসায়। Docker-এর প্রস্তাবিত রিস্টার্ট পলিসি থাকলে এটি নিজে থেকেই হয়।

আপনার বর্তমান ডেটাবেস /config/backups/before-restore-<time>-এ সরে যায়, ফলে রিস্টোর ফিরিয়ে নেওয়া যায়।

বিকল্প

কতক্ষণ পরপর

বিকল্প	কখন ব্যাকআপ নেয়	কী রাখে
Balanced (ভারসাম্য, ডিফল্ট)	প্রতিদিন	শেষ 7 দিন আর 4টি সাপ্তাহিক কপি
Light (হালকা)	সপ্তাহে একবার	4 সপ্তাহ। সবচেয়ে কম জায়গা লাগে
Careful (সতর্ক)	প্রতিদিন	30 দিন পর্যন্ত প্রতিটি কপি

সবচেয়ে নতুন সময়সূচি-মাফিক ব্যাকআপ সব সময় থাকে। এই নিয়মগুলো শুধু সময়সূচি-মাফিক ব্যাকআপ পরিষ্কার করে। আপনার নেওয়া ব্যাকআপ আপনি মুছে না দেওয়া পর্যন্ত থাকে (সারির ট্র্যাশ বোতাম; এটি ফেরানো যায় না)। যে আপডেট সেভ করা ডেটা বদলায়, তার আগেও HolyArrs ব্যাকআপ নেয় এবং সবচেয়ে নতুন 3টি রাখে; দেখুন আপডেট।

নতুন কম্পিউটারে যান

নতুন ইনস্টল প্রথমবার চালু হলে নিজের মাস্টার কী বানায়। সেই কী আপনার পুরোনো ব্যাকআপ খুলতে পারে না, তাই রিস্টোর প্রত্যাখ্যাত হয়। আগে পুরোনো কীটি জায়গায় রাখুন। উদাহরণগুলোতে কন্টেইনারের নাম holyarrs; আপনারটি ব্যবহার করুন।

1. প্রথমবার চালু করার আগে কন্টেইনার বানান, কিন্তু চালু করবেন না: docker compose create, অথবা আপনার docker run লাইনে docker run -d-এর জায়গায় docker create দিন।
2. পুরোনো কীটি কপি করুন: docker cp holyarrs.key holyarrs:/config/। নাম বদলে holyarrs.key করা কী কিটও চলে। নামযুক্ত ভলিউম বা হোস্ট ফোল্ডার, দুটোতেই এটি কাজ করে; HolyArrs চালু হওয়ার সময় /config-এর ফাইলগুলো আপনার PUID আর PGID-কে দিয়ে দেয়। আপনি HOLYARRS_MASTER_KEY_FILE ব্যবহার করলে কীটি হোস্টের ওই পাথে রাখুন, যেন আপনার PUID আর PGID সেটি পড়তে পারে।
3. ব্যাকআপ রিস্টোর করুন। একটি উপায় বেছে নিন:

   • HolyArrs চালু করুন, প্রথমবার চালু করার ধাপ শেষ করুন, তারপর Settings > Backups-এ Restore from a file ব্যবহার করুন।

   • অথবা প্রথমবার চালু করার আগেই রিস্টোর করুন। zip ফাইলটি নাম না বদলে backups নামের ফোল্ডারে রাখুন এবং docker cp backups holyarrs:/config/ দিয়ে কপি করুন। তারপর একই ইমেজ দিয়ে একবার রিস্টোর চালান:

     • Compose: docker compose run --rm holyarrs restore <zip name>
     • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>

     কী ফাইলের পাথ থাকলে -e HOLYARRS_MASTER_KEY_FILE=<its path> যোগ করুন, যাতে রিস্টোর আপনার কী দিয়ে যাচাই হয়। restore --list দেখায় সে কোন কোন ব্যাকআপের নাম দেখতে পাচ্ছে।

4. HolyArrs চালু করুন। আপনার লাইব্রেরি আর সেটিংস ফিরে এসেছে দেখতে পাবেন।

কী কপি করার আগেই নতুন ইনস্টল চালু করে ফেলেছেন? ওতে রাখার মতো কিছু না থাকলে HolyArrs বন্ধ করুন, একই docker cp দিয়ে পুরোনো কীটি নতুনটির ওপর কপি করুন, রিস্টোর করুন, তারপর চালু করুন।

কাজ না করলে

লক্ষণ: “Backups are off in this build” (এই বিল্ডে ব্যাকআপ বন্ধ)। কারণ: এই কপিটি ব্যাকআপ ম্যানেজার ছাড়া চলছে। সমাধান: অ্যাপে কিছু করার নেই; ব্যাকআপের কোনো কন্ট্রোল নেই।

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

লক্ষণ: মাস্টার কীয়ের কারণে রিস্টোর প্রত্যাখ্যাত হয়েছে। কারণ: কনফিগ ফোল্ডারের কী ব্যাকআপের সঙ্গে মেলে না। সমাধান: মিল থাকা holyarrs.key ফিরিয়ে রেখে আবার চেষ্টা করুন।

zip খুব বড় বা নষ্ট হলে, অপ্রত্যাশিত ফাইল থাকলে, নতুন ডেটাবেস ভার্সন থেকে এলে, বা আপনার কী যে ডেটা পড়তে পারে না সেই ডেটা থাকলেও রিস্টোর সেটি প্রত্যাখ্যান করে।

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

ব্যাকআপে কী থাকে

প্রতিটি ব্যাকআপ একটি zip, যাতে থাকে মূল ডেটাবেস, থাকলে Events ডেটাবেস, আর backup.json (HolyArrs-এর সংস্করণ, ডেটাবেসের ভার্সন, ব্যাকআপের ধরন, তৈরির সময়)। মিডিয়া, ডাউনলোড, আর্টওয়ার্ক, লগ আর মাস্টার কী এতে থাকে না।

প্রথমবার চালু করার আগে রিস্টোর

docker cp নামযুক্ত ভলিউম বা হোস্ট ফোল্ডার, দুটোতেই কাজ করে; HolyArrs চালু হওয়ার সময় /config-এর ফাইলগুলো আপনার PUID আর PGID-কে দিয়ে দেয়। HOLYARRS_MASTER_KEY_FILE থাকলে কীটি হোস্টের ওই পাথে রাখুন, যেন PUID আর PGID সেটি পড়তে পারে।

1. zip ফাইলটি নাম না বদলে backups নামের ফোল্ডারে রেখে কপি করুন: docker cp backups holyarrs:/config/।
2. একই ইমেজ দিয়ে একবার রিস্টোর চালান:
   • Compose: docker compose run --rm holyarrs restore <zip name>
   • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>
3. কী ফাইলের পাথ থাকলে -e HOLYARRS_MASTER_KEY_FILE=<its path> যোগ করুন, যাতে রিস্টোর আপনার কী দিয়ে যাচাই হয়।
4. HolyArrs চালু করুন।

restore --list দেখায় সে কোন কোন ব্যাকআপের নাম দেখতে পাচ্ছে।

সংশ্লিষ্ট

• আপডেট
• ইনস্টল
• হেলথ চেক