SSD Nodes Learn Hosting plans →
নির্দেশিকা Matt Connorদ্বারা Matt Connor · আপডেট করা হয়েছে 2026-11-07

কিভাবে নিজের সার্ভারে openGym সেলফ-হোস্ট করবেন

Docker Compose ব্যবহার করে openGym ডেপ্লয় করার নিয়ম জানুন। Passkey কনফিগারেশন, TLS সেটআপ এবং JSON ডেটা স্টোরেজসহ সেলফ-হোস্টিংয়ের খুঁটিনাটি এই গাইডে বিস্তারিত আলোচনা করা হয়েছে।

openGym সেলফ-হোস্ট করলে আপনি যা পাবেন

আপনি repository ক্লোন করে, .env-এ দুটি লাইন এডিট করে এবং TLS (transport layer security) টার্মিনেট করে এমন একটি reverse proxy-এর পেছনে docker compose up -d --build রান করার মাধ্যমে openGym সেলফ-হোস্ট করতে পারেন। openGym হলো একটি জিম এবং বডি ওয়েট ট্র্যাকার: এটি সাপ্তাহিক পরিকল্পনা, গাইডেড ওয়ার্কআউট, প্রতিটি সেটের লগ এবং সময়ের সাথে ওজনের পরিবর্তন ট্র্যাক করে। এটি AGPL-3.0 লাইসেন্সের অধীনে এবং এটি আপনার ডিস্কে সাধারণ JSON ফাইলে সবকিছু সংরক্ষণ করে, তাই আলাদা কোনো database server চালানোর প্রয়োজন হয় না।

এই স্ট্যাকটিতে দুটি দীর্ঘস্থায়ী কন্টেইনার থাকে: একটি nginx কন্টেইনার যা React বিল্ড সার্ভ করে এবং একটি Node কন্টেইনার যা API ধরে রাখে। এছাড়া প্রথমবার স্টার্ট করার সময় প্রায় 140 MB এক্সারসাইজ ইমেজ এবং GIF ডাউনলোড করার জন্য একটি one-shot জব রান করে।

পাবলিক সার্ভারে ডেপ্লয় করার ক্ষেত্রে প্রজেক্টের README-তে দুটি বিষয় ইঙ্গিত করা হয়েছে কিন্তু স্পষ্টভাবে বলা হয়নি। Passkey লগইন একটি hostname-এর সাথে আবদ্ধ থাকে, তাই প্রথম লগইনের আগেই ডোমেইন এবং এর certificate থাকতে হবে। আর ঐচ্ছিক MCP সার্ভারটি v1.2.7 ট্যাগ অনুযায়ী শুধুমাত্র read-only এবং এটি সেই মেশিনে চলে যেখানে আপনার AI ক্লায়েন্ট চলে, স্ট্যাকের ভেতরে নয়; যখন ডেটা একটি VPS-এ থাকে তখন এটি আপনার কাজের ধরনে পরিবর্তন আনে। বর্তমান MCP সার্ভারটি আপনার সার্ভারের সাথে পেয়ার করার পর ওয়ার্কআউট লগিংও সাপোর্ট করে।

openGym একটি নতুন প্রজেক্ট। প্রথম tagged release, v1.0.0, 20 জুলাই 2026 তারিখে এসেছে এবং v1.2.7 এসেছে 18 আগস্ট 2026 তারিখে। প্রথম মাসে তেরোটি ট্যাগ এবং 9 অক্টোবর 2026 পর্যন্ত 34টি ট্যাগ আসার অর্থ হলো অ্যাপটি এখনও দ্রুত পরিবর্তিত হচ্ছে, তাই default branch-এ যা আছে তা বিল্ড না করে একটি নির্দিষ্ট release tag ব্যবহার করুন।

প্রথম লগইনের আগেই ডোমেইন পরিকল্পনা করুন

openGym-এ সাইন ইন করার জন্য Passkeys ব্যবহার করা হয়। একটি passkey একটি relying party ID (RP ID)-এর সাথে যুক্ত থাকে, যা হলো সেই ডোমেইন যেখানে credential-টি তৈরি করা হয়েছে। ব্রাউজার শুধুমাত্র HTTPS-এর মাধ্যমেই passkey তৈরি করে। এর একমাত্র ব্যতিক্রম হলো localhost।

এর একটি ফলাফল ব্যবহারকারীরা তাদের ফোনে দেখতে পান। অন্য কোনো ডিভাইস থেকে http://203.0.113.10:8080 খুললে কোনো passkey প্রম্পট দেখা যায় না, কারণ ব্রাউজার plain HTTP origin বা সরাসরি IP address-এ কোনো credential তৈরি করতে অস্বীকার করে। প্রজেক্টের নিজস্ব ট্রাবলশুটিং নোটেও একই কথা বলা হয়েছে: কোনো প্রম্পট না আসার অর্থ হলো আপনি http:// অথবা কোনো IP-তে আছেন।

আরও খারাপ বিষয় হলো, RP ID প্রতিটি credential-এর ভেতরেই গেঁথে থাকে যা আপনার ব্যবহারকারীরা ইতিমধ্যে রেজিস্টার করেছেন। পরবর্তীতে RP_ID পরিবর্তন করলে তাদের ডিভাইসে সংরক্ষিত passkey-গুলো আর মিলবে না, ফলে কেউ সাইন ইন করতে পারবে না। তাই সবার আগে hostname নির্ধারণ করুন, DNS-কে VPS-এর দিকে পয়েন্ট করুন এবং কেউ Create profile-এ ট্যাপ করার আগেই certificate-এর কাজ সম্পন্ন করুন।

Docker Compose দিয়ে openGym ডেপ্লয় করা

এই compose ফাইলটি ./data এবং ./media-কে এর নিজস্ব অবস্থানের সাপেক্ষে bind-mount করে, তাই আপনি যে ডিরেক্টরিতে ক্লোন করবেন সেটিই আপনার ডাটাবেস হিসেবে কাজ করবে। এটি এমন কোনো জায়গায় রাখুন যা দীর্ঘস্থায়ী।

sudo install -d -o "$USER" -g "$USER" /opt/opengym
git clone https://github.com/DuarteSantos8/openGym /opt/opengym
cd /opt/opengym
git checkout v1.2.7
cp .env.example .env

README-তে একটি github.com/DuarteSantos8/openGym ক্লোন URL দেওয়া আছে। 4 নভেম্বর 2026 তারিখ অনুযায়ী, সেই রিপোজিটরিটির ঠিকানা সঠিক এবং এটি নিজেকে প্রজেক্টের মূল ঠিকানা হিসেবে দাবি করে। প্রথম বিল্ডের আগে ট্যাগটি চেক আউট করে নিন: ডিফল্ট ব্রাঞ্চটি এই গাইডে বর্ণিত ভার্সনের চেয়ে এগিয়ে গেছে, এবং সেখানে এক্সারসাইজ অ্যানিমেশনগুলো ইমেজের ভেতরেই থাকে, ফলে নিচের মিডিয়া জবটি আর কাজ করে না। pinning সংক্রান্ত সেকশনে এর কারণ ব্যাখ্যা করা হয়েছে।

.env ফাইলটি এডিট করুন। একটি VPS-এর ক্ষেত্রে তিনটি লাইন গুরুত্বপূর্ণ।

RP_ID=gym.example.com
ORIGIN=https://gym.example.com
WEB_PORT=127.0.0.1:8080

RP_ID হলো মূল হোস্টনাম এবং ORIGIN হলো স্কিমসহ সম্পূর্ণ URL। এগুলোকে ব্রাউজারের অ্যাড্রেস বারের সাথে হুবহু মিলতে হবে, অন্যথায় verification failed এর কারণে লগইন ব্যর্থ হবে। WEB_PORT ভ্যালুটি পোর্ট 8080 প্রাইভেট রাখার সেকশনে ব্যাখ্যা করা হয়েছে।

docker compose up -d --build
docker compose ps --all
docker compose logs media

docker compose ps --all কমান্ডটি চালালে web এবং api-কে running অবস্থায় এবং media-কে 0 কোডসহ exited অবস্থায় দেখানো উচিত। --all ফ্ল্যাগটি ব্যবহার করুন: এটি ছাড়া Compose শুধুমাত্র চলমান কন্টেইনারগুলো দেখায়, ফলে সম্পন্ন হওয়া media জবটি আর দেখা যাবে না। এই এক্সিটটি সঠিক: মিডিয়া জবের স্ট্যাটাস restart: "no", কারণ এর কাজ হলো একবার ডাউনলোড সম্পন্ন করা। এর লগের শেষ লাইনটি ✓ Exercise media ready দিয়ে শুরু হয় এবং ls media/img | wc -l-এর মান 0-এর পরিবর্তে 1,324 দেখানো উচিত, যা 9 অক্টোবর 2026 তারিখ অনুযায়ী আপস্ট্রিম এক্সারসাইজ ডেটাসেটে থাকা থাম্বনেইলের সংখ্যা। ডিরেক্টরি খালি থাকার অর্থ হলো ডাউনলোড ব্যর্থ হয়েছে, যার ফলে অ্যাপটি এক্সারসাইজ কার্ডগুলো খালি ইমেজসহ প্রদর্শন করবে।

--build ফ্ল্যাগটি ব্যবহার করুন। এই ট্যাগের compose ফাইলটি ghcr.io-এ latest ট্যাগসহ প্রি-বিল্ট ইমেজগুলোর নাম উল্লেখ করে। 18 অক্টোবর 2026 তারিখ অনুযায়ী ইমেজগুলো পুনরায় পাবলিশ করা হয়েছে, কিন্তু latest লেটেস্ট রিলিজ অনুসরণ করে, তাই docker compose pull কমান্ডটি আপনার চেক আউট করা সোর্সের চেয়ে নতুন কোড রান করবে। উভয় সার্ভিসেই একটি build সেকশন আছে এবং --build কমান্ডটি আপনার চেক আউট করা সোর্স থেকেই সেগুলোকে বিল্ড করে। আপনি যদি Compose-এর ব্যবহারে নতুন হন, তবে প্রথমে Docker Compose on a VPS পড়ুন এবং তারপর এখানে ফিরে আসুন।

ভার্সন পিন করুন, কারণ এই প্রজেক্টটি নতুন

Registry-তে আবার ভার্সনযুক্ত ইমেজ পাওয়া যাচ্ছে, কিন্তু v1.2.7-এর compose file এখনও latest চাইছে। 4 নভেম্বর 2026 অনুযায়ী, latest এখন 1.4.4-কে নির্দেশ করছে, যা 3 নভেম্বর 2026-এ রিলিজ হয়েছে। আপনি ডিস্কে যে চেকআউটটি পিন করবেন সেটিই গুরুত্বপূর্ণ, কারণ এটিই নির্ধারণ করে কোন ভার্সনের অ্যাপ্লিকেশন কন্টেইনারে থাকবে।

cd /opt/opengym
git fetch --tags
git checkout v1.2.7

git status এখন সেই ট্যাগে একটি detached HEAD দেখাচ্ছে, সার্ভারের ক্ষেত্রে আপনি এটাই চাইবেন। আপনি অন্য কোনো ট্যাগ চেকআউট না করা পর্যন্ত কোনো কিছুই পরিবর্তিত হবে না।

v1.2.7 হলো সেই রিলিজ যার ভিত্তিতে এই গাইডটি লেখা হয়েছে এবং এটি এখন আর নতুন নয়। পরবর্তী রিলিজগুলোতে ডেপ্লয়মেন্টের কাঠামো পরিবর্তিত হয়েছে (ডিফল্ট ব্রাঞ্চে media job আর নেই), তাই পিন পরিবর্তন করার আগে রিলিজ নোটগুলো পড়ুন এবং compose file-এর সাথে তুলনা করুন। v1.4.2 এবং v1.4.3 রিলিজ নোটে কিছু সিকিউরিটি ফিক্সের কথাও বলা হয়েছে এবং প্রজেক্ট কর্তৃপক্ষ সেলফ-হোস্টকারীদের আপডেট করার পরামর্শ দিয়েছে।

এরপর Compose-কে নির্দেশ দিন যেন এটি আর registry-র সাথে যোগাযোগ না করে। এটি docker-compose.override.yml-এ যুক্ত করুন, যা Compose স্বয়ংক্রিয়ভাবে লোড করে এবং ট্র্যাক করা ফাইলের ওপর মার্জ করে। Scalar key-গুলো override দ্বারা প্রতিস্থাপিত হয়, তাই git-এ কোনো কিছু এডিট করার প্রয়োজন নেই এবং git pull ক্লিন থাকে। মার্জ করার পূর্ণাঙ্গ নিয়ম জানতে how Compose merges an override file দেখুন।

services:
  api:
    pull_policy: build
  web:
    pull_policy: build

এটি কার্যকর করার পর, পরবর্তী docker compose up -d কমান্ডটি সেই দিন latest যা নির্দেশ করছে তা পুল না করে আপনার কাছে থাকা সোর্স থেকে বিল্ড করবে। মার্জটি কার্যকর হয়েছে কি না তা যাচাই করুন, তারপর সেই ট্যাগে পুনরায় বিল্ড করুন।

docker compose config | grep pull_policy
docker compose up -d --build

একটি reverse proxy ব্যবহার করে TLS termination

কন্টেইনারগুলো plain HTTP-তে কাজ করে। তাই সামনে এমন কিছু থাকতে হবে যা certificate-টি ধারণ করবে। Caddy হলো সবচেয়ে সহজ সমাধান, কারণ এটি নিজে থেকেই Let's Encrypt থেকে certificate অনুরোধ এবং নবায়ন করতে পারে।

gym.example.com {
    reverse_proxy 127.0.0.1:8080
}

nginx, Traefik এবং Nginx Proxy Manager—সবগুলোই একইভাবে কাজ করে। Cloudflare Tunnel-ও একই কাজ করে, যা এই প্রজেক্টের ডকুমেন্টেশনে উল্লেখ আছে এবং এর জন্য কোনো inbound port খোলার প্রয়োজন হয় না।

curl -sI https://gym.example.com | head -1

এটি কোনো certificate warning ছাড়াই HTTP/2 200 প্রদান করবে। এখন ব্রাউজারে সাইটটি খুলুন এবং Create profile-এ ট্যাপ করুন। যদি passkey প্রম্পট আসে এবং লগইন করার সময় verification failed, RP_ID অথবা ORIGIN দেখায়, তবে বুঝবেন এটি address bar-এর URL-এর সাথে মিলছে না। .env ঠিক করুন এবং পুনরায় docker compose up -d চালান, যা কন্টেইনারগুলোকে নতুন মানসহ পুনরায় তৈরি করবে। একটি docker compose restart কমান্ড .env-কে রিলোড করে না।

পোর্ট 8080-কে পাবলিক ইন্টারনেট থেকে দূরে রাখুন

ডিফল্টভাবে ওয়েব সার্ভিস প্রতিটি ইন্টারফেসে 8080 প্রকাশ করে, তাই প্রক্সি একই বক্সে HTTPS পরিবেশন করলেও অ্যাপটি আপনার পাবলিক IP-তে সাধারণ HTTP-এর মাধ্যমে অ্যাক্সেসযোগ্য থাকে। একটি ফায়ারওয়াল রুল দিয়ে এটি সমাধান করা যায় না। Docker একটি DNAT রুলের মাধ্যমে nat টেবিলে পোর্ট প্রকাশ করে এবং সেই ট্রাফিক তখন FORWARD চেইনে হ্যান্ডেল করা হয়, যেখানে Docker-এর নিজস্ব রুলগুলো তা গ্রহণ করে, অথচ ufw-এর রুলগুলো INPUT পাথে অবস্থান করে। তাই sudo ufw deny 8080/tcp কোনো কিছুই ব্লক করতে পারে না।

এর সমাধান হলো শুধুমাত্র লুপব্যাক অ্যাড্রেসে পোর্ট প্রকাশ করা। কম্পোজ ফাইলটি "${WEB_PORT:-8080}:${NGINX_PORT:-80}" ম্যাপ করে, তাই আপনি WEB_PORT-এ যা সেট করবেন তা সেই ম্যাপিংয়ের বাম দিকে প্রতিস্থাপিত হবে এবং Docker-এর সংক্ষিপ্ত সিনট্যাক্স সেখানে একটি ip:port জোড়া গ্রহণ করে। এই কারণেই WEB_PORT=127.0.0.1:8080 কাজ করে।

docker compose config
sudo ss -ltnp | grep 8080

মার্জ করা কনফিগারেশনে, ওয়েব সার্ভিসের ports-এর অধীনে আপনি host_ip: 127.0.0.1 দেখতে পাবেন। ss-এ 127.0.0.1:8080 দেখানো উচিত, 0.0.0.0:8080 নয়। অন্য কোনো মেশিন থেকে, curl http://<your-vps-ip>:8080 এখন রিফিউজ বা টাইম আউট হওয়া উচিত, তবে HTTPS হোস্টনাম কাজ করতে থাকবে।

আপনার প্রোফাইল তৈরি হওয়ার পর সাইনআপ বন্ধ করুন

ডিফল্টভাবে সাইনআপ খোলা থাকে এবং গেস্ট মোড চালু থাকে। একটি পাবলিক হোস্টনামে এর অর্থ হলো, যে কেউ URL খুঁজে পেলে আপনার সার্ভারে একটি প্রোফাইল তৈরি করতে পারবে। প্রথমে আপনার নিজের প্রোফাইলটি রেজিস্টার করুন, তারপর আপনার ইউজার আইডি খুঁজে বের করুন: ls data/ প্রতিটি ইউজারের জন্য state-<uid>.json নামে একটি ফাইল তালিকাভুক্ত করে এবং সেই <uid> হলো আপনার প্রয়োজনীয় মান।

ADMIN_UIDS=<your-uid>
INVITE_ONLY=1
ALLOW_GUEST=0

আবার docker compose up -d চালান। সেটিংস-এ এখন একটি অ্যাডমিন ড্যাশবোর্ড দেখা যাবে, যেখানে আপনি ইনভাইট কোড তৈরি এবং বাতিল করতে পারবেন। ফলে আপনি যাদের সাথে প্রশিক্ষণ নিচ্ছেন কেবল তারাই রেজিস্টার করতে পারবে এবং অন্য কেউ পারবে না। openGym বাইরের কোনো আইডেন্টিটি প্রোভাইডার সম্পর্কে জানে না, তাই এই ইনভাইট কোডগুলো কেবল এই অ্যাপটির জন্যই কাজ করবে, সার্ভারের অন্য কোনো কিছুর জন্য নয়। আপনি যদি আপনার সার্ভারের সব অ্যাপের জন্য প্রতি ব্যক্তির বিপরীতে একটি মাত্র অ্যাকাউন্ট রাখতে চান, তবে Authentik-কে ফরওয়ার্ড অথ প্রক্সি হিসেবে সামনে বসিয়ে openGym-এর নিজস্ব পাসকি লগইন লোড হওয়ার আগেই হোস্টনামটিকে সুরক্ষিত করতে পারেন।

ডেটা যেখানে থাকে এবং যে ব্যাকআপ তা সুরক্ষিত রাখে

সবকিছু ./data ডিরেক্টরিতে থাকে, যা /data-এ API কন্টেইনারের ভেতর মাউন্ট করা। এখানে চার ধরনের ফাইল আছে: db.json-এ প্রোফাইল এবং পাবলিক পাসকি ক্রেডেনশিয়াল থাকে, state-<uid>.json-এ একজন ব্যবহারকারীর রুটিন, ওয়ার্কআউট এবং শরীরের ওজন থাকে, secret হলো সেশন কুকি কি, এবং vapid.json-এ প্রথমবার চালানোর সময় তৈরি হওয়া পুশ নোটিফিকেশন কি থাকে।

cd /opt/opengym
docker compose stop api
tar czf ~/opengym-$(date +%F).tar.gz data/
docker compose start api

প্রথমে API বন্ধ করুন যাতে tar কপি করার সময় ফাইলগুলো একে অপরের সাথে সামঞ্জস্যপূর্ণ থাকে। v1.2.7 ভার্সনে, API ডেটাবেস এবং ওয়ার্কআউট-স্টেট JSON একটি অস্থায়ী ফাইলে লেখে এবং সেটিকে ডেস্টিনেশনের ওপর অ্যাটমিক্যালি রিনেম করে, তাই এটি সরাসরি লাইভ ফাইলগুলো ওভাররাইট করে না। এরপর আর্কাইভটি সার্ভার থেকে কপি করে সরিয়ে নিন, কারণ VPS-এ থাকা আর্কাইভ VPS নষ্ট হয়ে গেলে আর পাওয়া যাবে না। ব্যাকআপ থেকে media/ বাদ দিন: এটি 140 MB এক্সারসাইজ ইমেজের ফাইল, যা মিডিয়া জব পুনরায় বিনামূল্যে ডাউনলোড করে নিতে পারে।

রিস্টোর করার অর্থ হলো একই ডোমেইন সার্ভ করা কোনো হোস্টে একই পাথে ফাইলগুলো আনটার (untar) করা। আপনার ফোনে সংরক্ষিত পাসকি যে RP ID-তে তৈরি হয়েছিল তার সাথে আবদ্ধ থাকে, তাই নতুন হোস্টনামে রিস্টোর করলে আপনি এমন একটি কার্যকর ডেটাবেস পাবেন যেখানে কেউ লগইন করতে পারবে না। ডোমেইনটি একই রাখুন, অথবা প্রতিটি পাসকি পুনরায় রেজিস্টার করার পরিকল্পনা করুন। আপনি যা কিছু চালান তার সবকিছুর ক্ষেত্রেই একই নিয়ম প্রযোজ্য, এবং backing up and upgrading a Docker Compose stack সাধারণ রুটিনটি কভার করে।

পিন করা MCP সার্ভারটি রিড-অনলি এবং এটি আপনার মেশিনে চলে

MCP (model context protocol) হলো এমন একটি মাধ্যম যার সাহায্যে Claude Desktop বা Cursor-এর মতো ক্লায়েন্ট একটি লোকাল টুল সার্ভারের সাথে যোগাযোগ করে। openGym mcp/-এ একটি সার্ভার সরবরাহ করে। এটি compose ফাইলের অংশ নয়, এটি কোনো কন্টেইনার নয় এবং এটি কোনো পোর্টে লিসেন করে না। ক্লায়েন্ট এটিকে একটি চাইল্ড প্রসেস হিসেবে শুরু করে এবং stdio-এর মাধ্যমে এর সাথে যোগাযোগ করে। পিন করা সার্ভারটি শুধুমাত্র লোকাল ফাইল পড়তে পারে; বর্তমান সার্ভারটি আপনার পেয়ার করা openGym API-তে ওয়ার্কআউটের তথ্য পাঠায়।

এটি সার্ভারে নয়, বরং যেখানে ক্লায়েন্ট চলে সেখানে ইনস্টল করুন:

cd openGym/mcp
npm install

এরপর এটিকে claude_desktop_config.json-এ যোগ করুন:

{
  "mcpServers": {
    "opengym": {
      "command": "node",
      "args": ["/absolute/path/to/openGym/mcp/src/index.js"],
      "env": {
        "OPENGYM_DATA": "/absolute/path/to/openGym/data",
        "OPENGYM_UID": "<your-uid>"
      }
    }
  }
}

সিঙ্গেল-ইউজার ইনস্টলেশনের ক্ষেত্রে OPENGYM_UID ঐচ্ছিক, কারণ সার্ভারটি সেখানে থাকা একমাত্র প্রোফাইলটি স্বয়ংক্রিয়ভাবে শনাক্ত করতে পারে। বর্তমান ডিফল্ট ব্রাঞ্চে এটি এগারোটি টুল এক্সপোজ করে: list_routines, get_routine, preview_session, get_week_plan, list_workouts, get_workout, get_bodyweight, estimate_1rm, muscle_balance, get_programme এবং log_workout। preview_session দেখায় যে, প্রগ্রেশন পলিসি এবং আপনার হিস্ট্রি অনুযায়ী প্ল্যানটি ওভাররাইড হওয়ার পর, আপনি যখন একটি রুটিন শুরু করবেন তখন অ্যাপটি আসলে স্ক্রিনে কী দেখাবে। v1.2.7 ট্যাগটিতে আটটি রিড-অনলি টুল ছিল, যার মধ্যে preview_session, get_programme বা log_workout অন্তর্ভুক্ত ছিল না। সেই পিন করা সার্ভার ব্যবহারকারী একজন অ্যাসিস্ট্যান্ট গত সপ্তাহে আপনি কতটুকু বেঞ্চ প্রেস করেছেন তার উত্তর দিতে পারে, কিন্তু কোনো সেট লগ করতে, রুটিন এডিট করতে বা কিছু ডিলিট করতে পারে না। বর্তমান ব্রাঞ্চে, দশটি টুল রিড করে এবং log_workout পেয়ারিংয়ের পর আপনার সার্ভারের মাধ্যমে ওয়ার্কআউট সেভ করে; পেয়ার না করা পর্যন্ত এটি বন্ধ থাকে। এই তালিকাটি এজেন্ট ডিজাইনের সেই মূল সিদ্ধান্তের একটি সংক্ষিপ্ত উদাহরণ, যা হলো—আপনি যে টুলগুলো এক্সপোজ করবেন, মডেল শুধুমাত্র সেগুলোই ব্যবহার করতে পারবে। নিজে লুপ লিখে এজেন্ট কীভাবে কাজ করে তা শেখা হলো এটি বোঝার দ্রুততম উপায় যে, কেন রিড-অনলি টুল সেট একটি সীমাবদ্ধতা নয়, বরং একটি ডিজাইন চয়েস।

VPS ব্যবহারকারীদের জন্য সমাধানের অংশটি নিচে দেওয়া হলো। OPENGYM_DATA হলো একটি ফাইলসিস্টেম পাথ, এবং আপনার ডেটা VPS-এ থাকলেও আপনার AI ক্লায়েন্ট আপনার ল্যাপটপে থাকে। এই সমস্যার দুটি সৎ সমাধান রয়েছে।

  1. ডেটা কপি করে ডাউনলোড করুন এবং সার্ভারটিকে সেই কপির দিকে নির্দেশ করুন: rsync -a --delete user@gym.example.com:/opt/opengym/data/ ~/opengym-data/, এরপর OPENGYM_DATA-কে ~/opengym-data হিসেবে সেট করুন। পিন করা সার্ভারটি শুধুমাত্র রিড করে, তাই কপি করলে কোনো তথ্য হারাবে না। নতুন ডেটা চাইলে rsync পুনরায় চালান।
  2. command-কে ssh এবং args-কে ["-T", "user@gym.example.com", "OPENGYM_DATA=/opt/opengym/data node /opt/opengym/mcp/src/index.js"] হিসেবে সেট করে ssh-এর মাধ্যমে সার্ভারটি চালান। এর জন্য VPS-এ Node ইনস্টল থাকতে হবে এবং এমন একটি লগইন প্রয়োজন যা stdout-এ কিছু প্রিন্ট করে না, কারণ stdout হলো প্রোটোকল চ্যানেল।

উভয় অপশনই ধরে নেয় যে এজেন্টটি আপনার ল্যাপটপে থাকে। আপনি যদি চান এজেন্টটি ডেটার সাথে একই মেশিনে চলুক, তবে OneCLI প্রতিটি ব্যবহারকারীকে সার্ভারে একটি স্যান্ডবক্সড এজেন্ট দেয়, ফলে data/-এ stdio হপটি আবার লোকাল হয়ে যায়।

যদি cat data/db.json-এর আউটপুট Permission denied হয়, তবে এর অর্থ হলো API কন্টেইনার ফাইলগুলো root হিসেবে লিখেছে এবং আপনার লগইন সেগুলো পড়তে পারছে না। sudo ব্যবহার করে সেগুলো কপি করুন অথবা হোস্টে ফাইলগুলোর মালিকানা পরিবর্তন করুন। যে সার্ভারগুলো stdio-এর পরিবর্তে নেটওয়ার্কের মাধ্যমে লিসেন করার জন্য তৈরি, তাদের ক্ষেত্রে VPS-এ MCP সার্ভার চালানো দেখুন।

openGym নাকি wger: কোনটি আপনার চালানো উচিত?

এই ক্ষেত্রে wger একটি প্রতিষ্ঠিত বিকল্প এবং এটি অনেক বড় একটি সফটওয়্যার। এর compose stack-এ nginx-এর পেছনে gunicorn দ্বারা পরিচালিত একটি Django অ্যাপ্লিকেশন, PostgreSQL, Redis এবং একটি Celery worker থাকে। এর বিনিময়ে আপনি পুষ্টি ও উপাদানের ট্র্যাকিং, একটি ডকুমেন্টড REST API, ব্যায়ামের একটি বিশাল কমিউনিটি ডেটাবেস এবং অন্যদের পরিকল্পনা পরিচালনার জন্য ট্রেইনারদের উপযোগী ফিচার পাবেন।

openGym হলো দুটি কন্টেইনার এবং JSON ফাইলের একটি ফোল্ডার, যেখানে passkeys ছাড়া আর কোনো অ্যাকাউন্ট পরিচালনার প্রয়োজন নেই। মূল পার্থক্য এখানেই। আপনি যদি কখনো Chatwoot ইনস্টলেশন চালু রেখে থাকেন, যেখানে ব্যাকআপ মানে হলো Postgres ডাম্প এবং আপলোড ডিরেক্টরি সংরক্ষণ করা এবং প্রতিটি ভার্সন আপডেটে ডেটাবেস মাইগ্রেশন চালানো, তবে আপনি জানেন যে wger রক্ষণাবেক্ষণের জন্য কী ধরনের প্রস্তুতির প্রয়োজন।

আপনি যদি প্রশিক্ষণের পাশাপাশি খাবারের হিসাব রাখতে চান অথবা কোনো অ্যাপ তৈরির জন্য API-এর প্রয়োজন হয়, তবে wger ব্যবহার করুন। আর যদি এমন একটি ছোট স্ট্যাক চান যা এক বিকেলে পুরোপুরি পড়ে বোঝা সম্ভব এবং পাসওয়ার্ডহীন লগইন সুবিধা চান, তবে openGym বেছে নিন। এই পছন্দের মূল্য হলো পরিপক্কতা: 19 আগস্ট 2026 অনুযায়ী openGym-এর প্রথম রিলিজটি মাত্র এক মাস পুরনো, অন্যদিকে wger-এর পেছনে রয়েছে বহু বছরের রিলিজের ইতিহাস। আপনার ভার্সন পিন করে রাখুন, ব্যাকআপ রাখুন এবং প্রতিটি আপডেটের আগে রিলিজ নোটগুলো পড়ুন।

আপনার সার্ভারে কোনটি রাখা উচিত তা নিয়ে যদি এখনো সিদ্ধান্ত নিতে না পারেন, তবে 2026 সালে কোনগুলো সেলফ-হোস্ট করা সার্থক নিবন্ধটি পড়ুন। এই অ্যাপটি একই ছোট VPS-এ রেসিপির জন্য Mealie বা অর্থের হিসাবের জন্য Actual Budget-এর পাশাপাশি অনায়াসেই চলতে পারে।

কোনো কিছু না হারিয়ে আপডেট করা

cd /opt/opengym
docker compose stop api
tar czf ~/opengym-$(date +%F).tar.gz data/
docker compose start api
git fetch --tags

git checkout v<new> ব্যবহার করে আপনার কাঙ্ক্ষিত release-টি চেক আউট করুন, তারপর docker compose up -d --build কমান্ডটি চালান যাতে সেই tag থেকে কন্টেইনারগুলো পুনরায় তৈরি (rebuild) হয়। প্রতিবারই আগে ব্যাকআপ নিন, কারণ ডিস্কে থাকা JSON ফাইলগুলো রিস্টোর করার প্রক্রিয়াটি মাত্র একটি tar কমান্ডের বিষয় এবং এতে কয়েক সেকেন্ড সময় লাগে।

FAQ

কেন আমার ফোনে openGym কখনোই passkey প্রম্পট দেখায় না?

ব্রাউজারটি credential তৈরি করতে অস্বীকার করছে কারণ আপনি http:// অথবা http://192.168.1.20:8080-এর মতো কোনো bare IP ঠিকানায় আছেন। ব্রাউজার শুধুমাত্র HTTPS অরিজিনে passkey ব্যবহারের অনুমতি দেয়, যার একমাত্র ব্যতিক্রম হলো localhost। openGym-কে একটি reverse proxy-এর পেছনে রাখুন যা একটি প্রকৃত hostname-এর জন্য বৈধ certificate ধারণ করে, .env ফাইলে RP_ID=gym.example.com এবং ORIGIN=https://gym.example.com সেট করুন এবং docker compose up -d চালান যাতে কন্টেইনারগুলো নতুন মানগুলো গ্রহণ করতে পারে। যদি প্রম্পটটি আসে কিন্তু লগইনের সময় verification failed রিপোর্ট করে, তবে বুঝতে হবে যে এই দুটি মান ব্রাউজারের address bar-এ থাকা URL-এর সাথে হুবহু মিলছে না।

openGym আমার ডেটা কোথায় জমা রাখে এবং আমি কীভাবে এর ব্যাকআপ নেব?

এটি compose ফাইলের পাশে থাকা ./data ডিরেক্টরিতে থাকে, যা API কন্টেইনারে /data হিসেবে মাউন্ট করা হয়। এতে প্রোফাইল এবং পাবলিক passkey credential-এর জন্য db.json, ওয়ার্কআউট এবং শরীরের ওজনের জন্য প্রতি ব্যবহারকারীর একটি করে state-<uid>.json, সেশন কুকি কী-এর জন্য secret এবং পুশ নোটিফিকেশন কী-এর জন্য vapid.json থাকে। এর ব্যাকআপ নিতে প্রথমে docker compose stop api, তারপর tar czf ~/opengym-$(date +%F).tar.gz data/ এবং সবশেষে docker compose start api ব্যবহার করুন, এরপর আর্কাইভটি সার্ভার থেকে কপি করে নিন। media/ বাদ দিন, কারণ এটি 140 MB এক্সারসাইজ ইমেজ যা মিডিয়া জব নিজেই আবার ডাউনলোড করে নিতে পারে।

Claude কি আমার openGym ওয়ার্কআউট হিস্ট্রি পড়তে পারে?

হ্যাঁ, mcp/ ডিরেক্টরিতে থাকা ঐচ্ছিক MCP সার্ভারের মাধ্যমে এটি সম্ভব। পিন করা v1.2.7 সার্ভারে আটটি read-only টুল আছে। বর্তমান ডিফল্ট ব্রাঞ্চে এগারোটি টুল রয়েছে: দশটি রিড রুটিন, সেশন প্রিভিউ, সপ্তাহের পরিকল্পনা, ওয়ার্কআউট, শরীরের ওজন, আনুমানিক one-rep max, মাসল ব্যালেন্স এবং প্রোগ্রাম; log_workout পেয়ারিংয়ের পর আপনার সার্ভারের মাধ্যমে ওয়ার্কআউট রাইট করতে পারে। এটি কোনো কন্টেইনার নয় এবং কোনো পোর্ট খোলে না: আপনার ক্লায়েন্ট এটিকে stdio-এর মাধ্যমে শুরু করে এবং এর রিড টুলগুলো সরাসরি OPENGYM_DATA-এ থাকা JSON ফাইলগুলো অ্যাক্সেস করে। যেহেতু এটি একটি filesystem পাথ, তাই VPS-এ openGym চালানোর অর্থ হলো হয় data/-এর একটি কপি ক্লায়েন্ট চালিত মেশিনে সিঙ্ক করা, অথবা ক্লায়েন্ট কনফিগারেশন থেকে ssh-এর মাধ্যমে সার্ভারটি ইনভোক করা।

আমার কি openGym নাকি wger সেলফ-হোস্ট করা উচিত?

আপনি যদি আপনার ট্রেনিং লগের পাশাপাশি খাবার এবং পুষ্টির ট্র্যাকিং চান, অথবা কোনো কিছুর ওপর ভিত্তি করে তৈরি করার জন্য ডকুমেন্ট করা REST API চান, তবে wger বেছে নিন। এটি একটি বড় স্ট্যাক চালায়: nginx-এর পেছনে gunicorn-এর অধীনে Django, PostgreSQL, Redis এবং একটি Celery ওয়ার্কার। আপনি যদি দুটি কন্টেইনার, cat দিয়ে পড়তে পারেন এমন JSON ফাইল এবং পাসওয়ার্ড ম্যানেজ করার ঝামেলাহীন passkey লগইন চান, তবে openGym বেছে নিন। 19 আগস্ট 2026 অনুযায়ী, openGym-এর প্রথম tagged রিলিজটি এক মাস পুরনো, তাই প্রতিটি আপডেটের আগে একটি git tag চেক আউট করুন এবং data/-এর ব্যাকআপ নিন।

এই লেখাটি কি কাজে লেগেছে?