openGym को Docker पर self-host कैसे करें
Docker Compose का उपयोग करके openGym को VPS पर तैनात करने का तरीका जानें। इसमें TLS कॉन्फ़िगरेशन, डेटा स्टोरेज, v1.2.7 टैग की सीमाएं और MCP सर्वर सेटअप की पूरी जानकारी दी गई है।
openGym को self-host करने पर आपको क्या मिलता है
आप openGym को repository clone करके, .env में दो पंक्तियों को edit करके, और TLS (transport layer security) terminate करने वाले reverse proxy के पीछे docker compose up -d --build चलाकर self-host करते हैं। openGym एक gym और body weight tracker है: इसमें साप्ताहिक योजनाएं, guided workouts, हर set की logging, और समय के साथ वजन का रिकॉर्ड शामिल है। यह AGPL-3.0 लाइसेंस के अंतर्गत आता है और सब कुछ आपकी डिस्क पर plain JSON फाइलों में स्टोर करता है, इसलिए इसमें चलाने के लिए किसी database server की आवश्यकता नहीं होती है।
इसका stack दो long-running containers से बना है: एक nginx container जो React build को serve करता है और एक Node container जिसमें API होती है। इसके अलावा, एक one-shot job होती है जो पहली बार start करने पर लगभग 140 MB की exercise images और GIFs डाउनलोड करती है।
दो बातें जो project की README में निहित हैं, लेकिन public server पर deploy करने वाले व्यक्ति के लिए स्पष्ट नहीं की गई हैं। Passkey login एक hostname से बंधा होता है, इसलिए login से पहले domain और उसका certificate मौजूद होना चाहिए, बाद में नहीं। और optional MCP server, v1.2.7 tag पर read-only है और उस machine पर चलता है जहाँ आपका AI client चलता है, न कि stack के अंदर। जब data VPS पर स्थित हो, तो यह आपकी कार्यप्रणाली को बदल देता है। वर्तमान MCP server आपके server के साथ pairing के बाद workouts को log करने का भी समर्थन करता है।
openGym अभी नया है। पहला tagged release, v1.0.0, 20 July 2026 को आया था, और v1.2.7, 18 August 2026 को आया। पहले महीने में तेरह tags, और 9 October 2026 तक 34 tags के साथ v1.4.0 का आना यह दर्शाता है कि app अभी विकसित हो रहा है। इसलिए, default branch पर जो कुछ भी हो उसे build करने के बजाय, एक release tag का उपयोग करें।
पहली बार लॉगिन करने से पहले डोमेन की योजना बनाएं
Passkeys का उपयोग करके आप openGym में साइन इन करते हैं। एक passkey एक relying party ID (RP ID) से बंधी होती है, जो वह डोमेन है जिस पर credential बनाया गया था, और ब्राउज़र केवल HTTPS पर ही passkeys बनाते हैं। इसका एकमात्र अपवाद localhost है।
इसका एक परिणाम यह होता है जिसका सामना लोग अपने फोन पर करते हैं। किसी अन्य डिवाइस से http://203.0.113.10:8080 खोलें और कोई passkey प्रॉम्प्ट दिखाई नहीं देगा, क्योंकि ब्राउज़र plain HTTP origin या bare IP address पर credential बनाने से मना कर देता है। प्रोजेक्ट के अपने ट्रबलशूटिंग नोट्स भी यही कहते हैं: प्रॉम्प्ट न दिखने का मतलब है कि आप http:// पर हैं या किसी IP पर हैं।
इससे भी बुरा यह है कि RP ID आपके उन सभी credentials में समाहित (baked) हो जाती है जिन्हें आपके उपयोगकर्ताओं ने पहले ही रजिस्टर कर लिया है। यदि आप बाद में RP_ID बदलते हैं, तो उनके डिवाइस पर संग्रहीत passkeys अब मेल नहीं खाएंगी, इसलिए कोई भी साइन इन नहीं कर पाएगा। पहले होस्टनेम तय करें, 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 .envREADME में एक github.com/DuarteSantos8/openGym क्लोन URL दिया गया है। 4 नवंबर 2026 तक, वह रिपॉजिटरी रिज़ॉल्व होती है और खुद को प्रोजेक्ट का होम बताती है। पहले बिल्ड से पहले टैग को चेक आउट करें: डिफ़ॉल्ट ब्रांच उस वर्ज़न से आगे बढ़ चुकी है जिसका वर्णन इस गाइड में है, और उस पर एक्सरसाइज़ एनिमेशन इमेज के अंदर ही आते हैं और नीचे दिया गया मीडिया जॉब अब मौजूद नहीं है। पिनिंग पर दिया गया सेक्शन बताता है कि ऐसा क्यों है।
.env को एडिट करें। VPS पर तीन लाइनें महत्वपूर्ण हैं।
RP_ID=gym.example.com
ORIGIN=https://gym.example.com
WEB_PORT=127.0.0.1:8080RP_ID बेयर होस्टनेम है और ORIGIN स्कीम सहित पूरा URL है। इन्हें एड्रेस बार से बिल्कुल मेल खाना चाहिए, अन्यथा लॉगिन verification failed के साथ विफल हो जाता है। WEB_PORT वैल्यू को पोर्ट 8080 को प्राइवेट रखने वाले सेक्शन में समझाया गया है।
docker compose up -d --build
docker compose ps --all
docker compose logs mediadocker compose ps --all को web और api को रनिंग दिखाना चाहिए, और 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 आपके लिए नया है, तो VPS पर Docker Compose से शुरुआत करें और फिर वापस आएं।
वर्जन को पिन करें, क्योंकि यह प्रोजेक्ट अभी नया है
Registry में फिर से versioned images उपलब्ध हैं, लेकिन v1.2.7 पर मौजूद compose file अभी भी latest की मांग करती है। 4 November 2026 तक, latest 1.4.4 की ओर इशारा करता है, जिसे 3 November 2026 को release किया गया था। आप डिस्क पर जिस checkout को पिन करते हैं, वही तय करता है कि container में application का कौन सा version जाएगा।
cd /opt/opengym
git fetch --tags
git checkout v1.2.7git status अब उस tag पर एक detached HEAD दिखाता है, जो कि सर्वर पर आप चाहते भी हैं। जब तक आप किसी दूसरे tag को checkout नहीं करते, तब तक कुछ भी नहीं बदलेगा।
v1.2.7 वह release है जिसके आधार पर यह गाइड लिखी गई थी, और अब यह सबसे नया version नहीं है। बाद के releases में deployment में बदलाव किए गए हैं (default branch पर media job को हटा दिया गया है), इसलिए पिन बदलने से पहले release notes पढ़ें और compose file की तुलना करें। v1.4.2 और v1.4.3 के release notes में security fixes की जानकारी भी दी गई है, और प्रोजेक्ट ने self-hosters को update करने के लिए कहा है।
इसके बाद Compose को निर्देश दें कि वह registry से image pull करना बंद कर दे। इसे docker-compose.override.yml में डालें, जिसे Compose अपने आप load करता है और track की गई file के ऊपर merge कर देता है। Scalar keys को override द्वारा बदल दिया जाता है, इसलिए git में कुछ भी edit करने की आवश्यकता नहीं होती और git pull साफ रहता है। merge के पूर्ण नियमों के लिए Compose override file को कैसे merge करता है देखें।
services:
api:
pull_policy: build
web:
pull_policy: buildएक बार यह लागू हो जाने पर, बाद में चलाया गया docker compose up -d आपके पास मौजूद source से build होगा, न कि उस दिन latest जिस image की ओर इशारा कर रहा है उसे pull करेगा। जाँच लें कि merge प्रभावी हो गया है, और फिर tag पर rebuild करें।
docker compose config | grep pull_policy
docker compose up -d --buildरिवर्स प्रॉक्सी के साथ TLS समाप्त करना
कंटेनर plain HTTP का उपयोग करते हैं। सामने मौजूद किसी घटक को certificate संभालना होता है। Caddy सबसे सरल विकल्प है, क्योंकि यह Let's Encrypt से certificate का अनुरोध और नवीनीकरण (renewal) स्वयं करता है।
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इससे HTTP/2 200 वापस आना चाहिए और कोई certificate warning नहीं दिखनी चाहिए। अब ब्राउज़र में साइट खोलें और Create profile पर टैप करें। यदि passkey prompt दिखाई देता है और फिर login करने पर verification failed, RP_ID या ORIGIN रिपोर्ट होता है, तो इसका मतलब है कि यह address bar में मौजूद URL से मेल नहीं खाता है। .env को ठीक करें और फिर से docker compose up -d चलाएँ, जो कंटेनरों को फिर से बनाता है ताकि वे नए मान (values) पढ़ सकें। docker compose restart करने से .env रीलोड नहीं होता है।
Port 8080 को public internet से दूर रखें
डिफ़ॉल्ट रूप से, web service 8080 को हर interface पर publish करती है। इसलिए, जब proxy उसी box पर HTTPS serve कर रहा होता है, तब भी app आपके public IP पर plain HTTP के जरिए पहुँच योग्य होती है। एक firewall rule इसे ठीक नहीं करता है। Docker एक port को nat table में DNAT rule के साथ publish करता है, और उस traffic को फिर FORWARD chain में handle किया जाता है जहाँ Docker के अपने rules उसे स्वीकार कर लेते हैं, जबकि ufw के rules INPUT path पर स्थित होते हैं। इसलिए sudo ufw deny 8080/tcp कुछ भी block नहीं करता है।
इसका समाधान केवल loopback address पर publish करना है। Compose file "${WEB_PORT:-8080}:${NGINX_PORT:-80}" को map करती है, इसलिए आप WEB_PORT में जो भी set करते हैं, वह उस mapping के बाईं ओर प्रतिस्थापित (substitute) हो जाता है, और Docker का short syntax वहाँ एक ip:port pair स्वीकार करता है। इसीलिए WEB_PORT=127.0.0.1:8080 काम करता है।
docker compose config
sudo ss -ltnp | grep 8080Merged config में, web service के ports के अंतर्गत, आपको host_ip: 127.0.0.1 दिखाई देना चाहिए। ss को 127.0.0.1:8080 दिखाना चाहिए, न कि 0.0.0.0:8080। किसी अन्य machine से, curl http://<your-vps-ip>:8080 को अब refuse हो जाना चाहिए या time out हो जाना चाहिए, जबकि HTTPS hostname काम करना जारी रखेगा।
अपनी प्रोफाइल बनने के बाद साइनअप बंद करें
साइनअप डिफ़ॉल्ट रूप से खुला रहता है और गेस्ट मोड चालू रहता है। एक पब्लिक होस्टनेम पर इसका मतलब है कि जो कोई भी URL ढूँढ लेगा, वह आपके सर्वर पर प्रोफाइल बना सकता है। पहले अपनी खुद की प्रोफाइल रजिस्टर करें, फिर अपनी यूजर ID ढूँढें: ls data/ प्रत्येक यूजर के लिए state-<uid>.json नाम की एक फाइल लिस्ट करता है, और वह <uid> ही वह वैल्यू है जिसकी आपको आवश्यकता है।
ADMIN_UIDS=<your-uid>
INVITE_ONLY=1
ALLOW_GUEST=0docker compose up -d को फिर से चलाएँ। सेटिंग्स में अब एक एडमिन डैशबोर्ड दिखाई देता है जहाँ आप इनवाइट कोड जनरेट और रिवोक (revoke) कर सकते हैं, ताकि केवल वे लोग रजिस्टर कर सकें जिनके साथ आप ट्रेनिंग करते हैं और कोई अन्य नहीं। openGym बाहरी आइडेंटिटी प्रोवाइडर्स के बारे में कुछ नहीं जानता है, इसलिए वे इनवाइट कोड केवल इसी एक ऐप को नियंत्रित करते हैं और बॉक्स पर मौजूद किसी अन्य चीज़ को नहीं; यदि आप जो कुछ भी रन करते हैं, उस पर प्रति व्यक्ति एक ही अकाउंट देना पसंद करते हैं, तो Authentik को फॉरवर्ड ऑथ प्रॉक्सी के रूप में सामने रखने से openGym का अपना पासकी लॉगिन लोड होने से पहले ही होस्टनेम सुरक्षित हो जाता है।
डेटा कहाँ रहता है, और उसे सुरक्षित रखने वाला बैकअप
सब कुछ ./data डायरेक्टरी में है, जिसे API कंटेनर में /data पर माउंट किया गया है। यहाँ चार प्रकार की फाइलें हैं: db.json में प्रोफाइल और पब्लिक passkey क्रेडेंशियल्स होते हैं, 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 को रोकें ताकि फाइलें एक-दूसरे के साथ सुसंगत (consistent) रहें, जब tar उन्हें कॉपी करे। v1.2.7 पर, API डेटाबेस और workout-state JSON को एक अस्थायी फाइल में लिखता है और उसे डेस्टिनेशन पर परमाणु रूप से (atomically) रीनेम कर देता है, इसलिए यह उन लाइव फाइलों को सीधे ओवरराइट नहीं करता है। इसके बाद आर्काइव को सर्वर से बाहर कॉपी करें, क्योंकि VPS पर रखा गया आर्काइव VPS के खराब होने पर सुरक्षित नहीं रहता। बैकअप से media/ को बाहर रखें: यह 140 MB की एक्सरसाइज इमेजेस हैं जिन्हें मीडिया जॉब दोबारा मुफ्त में डाउनलोड कर लेती है।
रिस्टोर करने का मतलब है उसी डोमेन पर काम कर रहे होस्ट पर उसी पाथ में untar करना। आपके फोन पर स्टोर की गई passkey उसी RP ID तक सीमित होती है जिस पर वह बनाई गई थी, इसलिए नए होस्टनेम पर रिस्टोर करने से आपको एक ऐसा डेटाबेस तो मिल जाएगा जो काम कर रहा है, लेकिन उसमें कोई भी साइन-इन नहीं कर पाएगा। डोमेन को वही रखें, या फिर हर passkey को दोबारा रजिस्टर करने की योजना बनाएं। यही अनुशासन आपके द्वारा चलाए जाने वाले बाकी सभी चीजों पर भी लागू होता है, और Docker Compose स्टैक का बैकअप लेना और अपग्रेड करना सामान्य रूटीन को कवर करता है।
पिन किया गया MCP सर्वर read-only है और यह आपकी मशीन पर चलता है
MCP (model context protocol) वह तरीका है जिससे Claude Desktop या Cursor जैसा क्लाइंट एक लोकल टूल सर्वर से बात करता है। openGym इसे mcp/ में प्रदान करता है। यह compose file का हिस्सा नहीं है, यह कोई container नहीं है, और यह किसी port पर listen नहीं करता है। क्लाइंट इसे एक child process के रूप में शुरू करता है और stdio के माध्यम से इससे बात करता है। पिन किया गया सर्वर केवल लोकल फाइलों को पढ़ता है; वर्तमान सर्वर आपके paired 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 सिंगल-यूज़र इंस्टॉल पर वैकल्पिक है, जहां सर्वर को मिलने वाला एकमात्र प्रोफाइल वह स्वयं डिटेक्ट कर लेता है। वर्तमान डिफ़ॉल्ट ब्रांच पर यह ग्यारह टूल्स expose करता है: 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 दिखाता है कि जब आप कोई रूटीन शुरू करते हैं, तो ऐप वास्तव में स्क्रीन पर क्या दिखाएगा, यह progression policy और आपके इतिहास द्वारा प्लान को ओवरराइड करने के बाद होता है। v1.2.7 टैग में आठ read-only टूल्स थे, जिनमें preview_session, get_programme या log_workout शामिल नहीं थे। उस पिन किए गए सर्वर का उपयोग करने वाला असिस्टेंट यह जवाब दे सकता है कि आपने पिछले सप्ताह कितना बेंच प्रेस किया था, लेकिन वह कोई सेट लॉग नहीं कर सकता, रूटीन एडिट नहीं कर सकता, या कुछ भी डिलीट नहीं कर सकता। वर्तमान ब्रांच पर, दस टूल्स रीड करते हैं और log_workout पेयरिंग के बाद आपके सर्वर के माध्यम से वर्कआउट सेव करता है; पेयर होने तक यह बंद रहता है। वह सूची उस एक निर्णय का संक्षिप्त उदाहरण है जिस पर एजेंट डिज़ाइन बार-बार वापस आता है, जो यह है कि आप जो टूल्स expose करते हैं, वही मॉडल की पूरी क्षमता है, और लूप को स्वयं लिखकर यह सीखना कि एजेंट कैसे काम करते हैं यह समझने का सबसे तेज़ तरीका है कि read-only टूल सेट एक डिज़ाइन विकल्प है, न कि कोई सीमा।
यहाँ वह हिस्सा है जिसे VPS यूज़र को हल करना होगा। OPENGYM_DATA एक फाइलसिस्टम पाथ है, और आपका डेटा VPS पर है जबकि आपका AI क्लाइंट आपके लैपटॉप पर है। इसके लिए दो ईमानदार विकल्प हैं।
- डेटा को कॉपी करें और सर्वर को उस कॉपी पर पॉइंट करें:
rsync -a --delete user@gym.example.com:/opt/opengym/data/ ~/opengym-data/, फिरOPENGYM_DATAको~/opengym-dataपर सेट करें। पिन किया गया सर्वर केवल रीड करता है, इसलिए कॉपी करने से कुछ भी खोता नहीं है। जब आपको ताज़ा डेटा चाहिए हो, तो rsync को फिर से चलाएं। - सर्वर को ssh पर चलाएं, जिसमें
commandकोsshपर औरargsको["-T", "user@gym.example.com", "OPENGYM_DATA=/opt/opengym/data node /opt/opengym/mcp/src/index.js"]पर सेट करें। इसके लिए VPS पर Node इंस्टॉल होना चाहिए, और एक ऐसा लॉगिन होना चाहिए जो stdout पर कुछ भी प्रिंट न करे, क्योंकि stdout ही प्रोटोकॉल चैनल है।
दोनों विकल्प यह मानकर चलते हैं कि एजेंट स्वयं आपके लैपटॉप पर रहता है, और यदि आप चाहते हैं कि यह डेटा वाले बॉक्स पर ही चले, तो OneCLI प्रत्येक व्यक्ति को सर्वर पर एक सैंडबॉक्स एजेंट देता है ताकि data/ तक का stdio हॉप फिर से लोकल हो जाए।
यदि cat data/db.json, Permission denied रिटर्न करता है, तो API कंटेनर ने उन फाइलों को root के रूप में लिखा है और आपका लॉगिन उन्हें पढ़ नहीं सकता है। उन्हें sudo के साथ कॉपी करें, या होस्ट पर ओनरशिप बदलें। उन सर्वर्स के लिए जिन्हें stdio के बजाय नेटवर्क पर listen करना है, देखें VPS पर MCP सर्वर्स चलाना।
openGym या wger: आपको क्या चलाना चाहिए?
wger इस क्षेत्र में एक स्थापित विकल्प है और यह काफी बड़ा सॉफ्टवेयर है। इसका compose stack nginx के पीछे gunicorn, एक Django application, PostgreSQL, Redis और एक Celery worker चलाता है। इसके बदले में आपको पोषण और सामग्री ट्रैकिंग, एक प्रलेखित REST API, व्यायामों का एक बड़ा सामुदायिक डेटाबेस और अन्य लोगों की योजनाओं को प्रबंधित करने वाले प्रशिक्षकों के लिए फीचर्स मिलते हैं।
openGym में दो containers और JSON फाइलों का एक फोल्डर होता है, और passkeys के अलावा प्रबंधित करने के लिए कोई accounts नहीं होते। यही पूरा अंतर है। यदि आपने कभी Chatwoot install को चलाकर रखा है, जहाँ backup का मतलब Postgres dump के साथ-साथ uploads directory है और हर version bump के साथ database migrations अपने आप चलते हैं, तो आप पहले से ही जानते हैं कि wger के रखरखाव में आपसे क्या अपेक्षा की जाती है।
यदि आप प्रशिक्षण के साथ-साथ भोजन को भी ट्रैक करना चाहते हैं, या यदि आपको build करने के लिए API की आवश्यकता है, तो wger चलाएं। यदि आप ऐसा stack चाहते हैं जो इतना छोटा हो कि उसे एक दोपहर में पूरा पढ़ा जा सके, और ऐसा login चाहते हैं जिसमें leak होने के लिए कोई password न हो, तो openGym चलाएं। इस विकल्प की कीमत परिपक्वता है: 19 August 2026 तक openGym का पहला release एक महीने पुराना है, जबकि wger के पीछे वर्षों के releases हैं। अपने version को pin करें, backups रखें और प्रत्येक update से पहले release notes पढ़ें।
यदि आप अभी भी यह तय कर रहे हैं कि सर्वर पर क्या जगह पाने के हकदार है, तो 2026 में self-hosting के लिए क्या उपयोगी है में इन trade-offs को कवर किया गया है, और यह app उसी छोटे VPS पर recipes के लिए 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जिस release पर आप जाना चाहते हैं उसे git checkout v<new> के साथ checkout करें, फिर docker compose up -d --build चलाएं ताकि containers उस tag से फिर से build हो जाएं। हर बार सबसे पहले backup लें, क्योंकि डिस्क पर मौजूद JSON files को restore करने का तरीका केवल एक tar command है और इसमें कुछ ही सेकंड लगते हैं।
FAQ
मेरे फोन पर openGym कभी passkey prompt क्यों नहीं दिखाता है?
Browser credential बनाने से मना कर रहा है क्योंकि आप http:// पर हैं या http://192.168.1.20:8080 जैसे bare IP address का उपयोग कर रहे हैं। Browser केवल HTTPS origins पर ही passkeys की अनुमति देते हैं, जिसमें localhost एकमात्र अपवाद है। openGym को एक वास्तविक hostname के लिए वास्तविक certificate रखने वाले reverse proxy के पीछे रखें, .env में RP_ID=gym.example.com और ORIGIN=https://gym.example.com सेट करें, और docker compose up -d चलाएं ताकि containers नए मानों को उठा सकें। यदि prompt दिखाई देता है लेकिन login verification failed रिपोर्ट करता है, तो इसका मतलब है कि वे दो मान address bar में मौजूद URL से बिल्कुल मेल नहीं खाते हैं।
openGym मेरा डेटा कहाँ स्टोर करता है, और मैं इसका बैकअप कैसे लूँ?
यह compose file के बगल में स्थित ./data directory में होता है, जिसे API container में /data के रूप में mount किया जाता है। इसमें profiles और public passkey credentials के लिए db.json, workouts और body weight के लिए प्रति उपयोगकर्ता एक state-<uid>.json, session cookie key के लिए secret, और push notification keys के लिए vapid.json होता है। इसका बैकअप लेने के लिए docker compose stop api, फिर tar czf ~/opengym-$(date +%F).tar.gz data/, और फिर docker compose start api का उपयोग करें, और archive को सर्वर से बाहर copy कर लें। media/ को छोड़ दें, जो 140 MB की exercise images हैं जिन्हें media job अपने आप फिर से download कर लेती है।
क्या Claude मेरा openGym workout history पढ़ सकता है?
हाँ, mcp/ directory में मौजूद वैकल्पिक MCP server के माध्यम से। Pinned v1.2.7 server में आठ read-only tools हैं। वर्तमान default branch में ग्यारह tools हैं: दस read routines, session previews, week plans, workouts, body weight, estimated one-rep max, muscle balance और programmes; log_workout pairing के बाद आपके सर्वर के माध्यम से workouts लिखता है। यह कोई container नहीं है और कोई port नहीं खोलता है: आपका client इसे stdio पर शुरू करता है और इसके read tools सीधे OPENGYM_DATA पर मौजूद JSON files को access करते हैं। चूँकि यह एक filesystem path है, इसलिए openGym को VPS पर चलाने का मतलब है या तो data/ की एक copy को उस machine पर sync करना जहाँ client चल रहा है, या client config से ssh के माध्यम से server को invoke करना।
क्या मुझे openGym या wger को self-host करना चाहिए?
यदि आप अपने training log के साथ भोजन और पोषण (nutrition) को track करना चाहते हैं, या निर्माण करने के लिए एक documented REST API चाहते हैं, तो wger चुनें। यह एक बड़ा stack चलाता है: nginx के पीछे gunicorn के अंतर्गत Django, PostgreSQL, Redis और एक Celery worker। यदि आप दो containers, ऐसी JSON files जिन्हें आप cat के साथ पढ़ सकें, और बिना password वाला passkey login चाहते हैं, तो openGym चुनें। 19 August 2026 तक, openGym का पहला tagged release एक महीने पुराना है, इसलिए हर update से पहले git tag देखें और data/ का बैकअप लें।