SSD Nodes Learn Hosting plans →
Rehberler Matt ConnorYazan Matt Connor · Güncellendi 2026-11-06

openGym Docker Compose ile kendi sunucunda barındırma

openGym uygulamasını Docker Compose kullanarak VPS üzerinde nasıl kuracağınızı öğrenin. Passkey kurulumu için gerekli TLS yapılandırması ve veri dizini detayları yer alıyor.

openGym uygulamasını kendi sunucunuzda barındırdığınızda elde edecekleriniz

openGym uygulamasını, depoyu klonlayarak, .env dosyasındaki iki satırı düzenleyerek ve TLS (taşıma katmanı güvenliği) sonlandırması yapan bir reverse proxy arkasında docker compose up -d --build komutunu çalıştırarak kendi sunucunuzda barındırabilirsiniz. openGym; haftalık planlar, rehberli antrenmanlar, kaydedilen her set ve zaman içindeki ağırlık takibi özelliklerine sahip bir spor salonu ve vücut ağırlığı takip uygulamasıdır. AGPL-3.0 lisansına sahiptir ve tüm verileri disk üzerinde düz JSON dosyalarında saklar; bu nedenle çalıştırılması gereken bir veritabanı sunucusu bulunmaz.

Teknoloji yığını, React derlemesini sunan bir nginx container'ı, API'yi barındıran bir Node container'ı ve ilk başlatmada yaklaşık 140 MB boyutundaki egzersiz görselleri ile GIF'lerini indiren tek seferlik bir işten oluşur.

Projenin README dosyasında ima edilen ancak halka açık bir sunucuda dağıtım yapanlar için açıkça belirtilmeyen iki husus vardır. Passkey ile giriş, bir ana makine adına (hostname) bağlıdır; bu nedenle alan adı ve sertifikası, ilk girişten sonra değil, girişten önce mevcut olmalıdır. İsteğe bağlı MCP sunucusu, v1.2.7 etiketinde salt okunurdur ve yığının içinde değil, yapay zeka istemcinizin çalıştığı makinede çalışır; bu durum, veriler bir VPS üzerinde olduğunda yapmanız gerekenleri değiştirir. Mevcut MCP sunucusu, sunucunuzla eşleştikten sonra antrenmanların kaydedilmesini de destekler.

openGym henüz yeni bir projedir. İlk etiketli sürüm olan v1.0.0, 20 Temmuz 2026 tarihlidir ve v1.2.7 sürümü 18 Ağustos 2026 tarihinde yayınlanmıştır. İlk ayında on üç, 9 Ekim 2026 itibarıyla v1.4.0 sürümüyle birlikte toplam 34 etiket yayınlanmış olması, uygulamanın hala geliştirilme aşamasında olduğunu gösterir; bu nedenle varsayılan dalda (default branch) ne olduğuna bakmak yerine bir sürüm etiketini (release tag) kontrol ederek ilerleyin.

İlk oturum açma işleminden önce alan adını planlayın

openGym'de oturum açmak için passkey kullanılır. Bir passkey, kimlik bilgisinin oluşturulduğu alan adı olan bir relying party ID (RP ID) ile ilişkilendirilir ve tarayıcılar passkey'leri yalnızca HTTPS üzerinden oluşturur. Bunun tek istisnası localhost durumudur.

Bu durumun, kullanıcıların telefonlarında karşılaştığı bir sonucu vardır. http://203.0.113.10:8080 uygulamasını başka bir cihazdan açtığınızda hiçbir passkey istemi görünmez; çünkü tarayıcı, düz HTTP kaynağı veya doğrudan IP adresi üzerinde kimlik bilgisi oluşturmayı reddeder. Projenin kendi sorun giderme notlarında da belirtildiği gibi, istemin görünmemesi http:// üzerinde olduğunuz veya bir IP adresi kullandığınız anlamına gelir.

Daha da kötüsü, RP ID kullanıcılarınızın halihazırda kaydettiği her kimlik bilgisinin içine işlenmiştir. RP_ID değerini daha sonra değiştirirseniz, cihazlarda kayıtlı olan passkey'ler artık eşleşmeyeceği için kimse oturum açamaz. Ana bilgisayar adını (hostname) önceden belirleyin, DNS kayıtlarını VPS'e yönlendirin ve kimse "Create profile" düğmesine basmadan önce sertifikanın çalıştığından emin olun.

Docker Compose ile openGym kurulumu

Compose dosyası, ./data ve ./media dizinlerini kendisine göre bind-mount eder; bu nedenle klonlama yaptığınız dizin veritabanınızın ta kendisidir. Bu dizini kalıcı bir alana yerleştirin.

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 dosyası bir github.com/DuarteSantos8/openGym klonlama URL'si sunar. 4 Kasım 2026 itibarıyla bu depo çözümlenmekte ve kendisini projenin ana sayfası olarak tanımlamaktadır. İlk derlemeden önce ilgili etiketi (tag) kontrol edin: varsayılan dal, bu kılavuzun tanımladığı sürümün ilerisine geçmiştir ve o dalda egzersiz animasyonları imajın içinde gelmekte olup aşağıdaki medya işi artık mevcut değildir. Sabitleme (pinning) hakkındaki bölüm bunun nedenini açıklar.

.env dosyasını düzenleyin. Bir VPS üzerinde üç satır önem arz eder.

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

RP_ID çıplak ana makine adıdır (hostname), ORIGIN ise şema dahil tam URL'dir. Bunlar adres çubuğuyla tam olarak eşleşmelidir, aksi takdirde giriş işlemi verification failed hatasıyla başarısız olur. WEB_PORT değeri, 8080 numaralı portun gizli tutulması hakkındaki bölümde açıklanmıştır.

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

docker compose ps --all komutu web ve api servislerini çalışıyor (running), media servisini ise 0 koduyla çıkış yapmış (exited) olarak göstermelidir. --all bayrağını kullanmaya devam edin: bu bayrak olmadan Compose yalnızca çalışan container'ları listeler, bu nedenle tamamlanmış media işi hiç görünmez. Bu çıkış durumu doğrudur: medya işi restart: "no" durumundadır çünkü yaptığı iş tek seferlik bir indirme işlemidir. Günlük kaydı ✓ Exercise media ready ile başlayan bir satırla biter ve ls media/img | wc -l komutu 0 yerine 1,324 değerini yazdırmalıdır; bu sayı, 9 Ekim 2026 itibarıyla yukarı akış (upstream) egzersiz veri setinin sunduğu küçük resim sayısıdır. Dizinin boş olması indirme işleminin başarısız olduğu anlamına gelir ve bu durumda uygulama, egzersiz kartlarını boş görsellerle oluşturur.

--build bayrağını koruyun. Bu etiketteki Compose dosyası, ghcr.io üzerindeki önceden derlenmiş imajları latest etiketiyle adlandırır. Bu imajlar 18 Ekim 2026 itibarıyla yeniden yayınlanmıştır, ancak latest en yeni sürümü takip eder; bu nedenle docker compose pull, az önce kontrol ettiğiniz kaynaktan daha yeni bir kod çalıştıracaktır. Her iki servis de bir build bölümü içerir ve --build bunları sizin kontrol ettiğiniz kaynak üzerinden derler. Eğer Compose sizin için yeniyse, önce VPS üzerinde Docker Compose bölümünden başlayıp buraya geri dönün.

Sürümü sabitleyin, çünkü bu proje henüz yeni

Kayıt defteri (registry) tekrar sürümlü imajlar barındırıyor, ancak v1.2.7 sürümündeki compose dosyası hala latest değerini talep ediyor. 4 Kasım 2026 itibarıyla latest, 3 Kasım 2026 tarihinde yayınlanan 1.4.4 sürümünü işaret etmektedir. Sabitlediğiniz şey disk üzerindeki checkout işlemidir, çünkü konteyner içine hangi uygulama sürümünün gireceğine bu karar verir.

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

git status artık o etiket üzerinde detached HEAD durumu bildiriyor; sunucuda istediğiniz durum tam olarak budur. Siz farklı bir etiket checkout etmediğiniz sürece hiçbir şey değişmez.

v1.2.7, bu rehberin yazıldığı sırada kullanılan sürümdür ve artık en güncel sürüm değildir. Daha sonraki sürümler dağıtımın kendisini değiştirmektedir (varsayılan dalda media işi kaldırılmıştır), bu nedenle sürüm notlarını okuyun ve sabitleme işlemini değiştirmeden önce compose dosyasını karşılaştırın. v1.4.2 ve v1.4.3 sürüm notları ayrıca güvenlik düzeltmeleri bildirmektedir ve proje, kendi sunucusunu barındıran kullanıcıların güncellemelerini tavsiye etmektedir.

Ardından Compose'a kayıt defterine ulaşmayı tamamen bırakmasını söyleyin. Bunu, Compose'un otomatik olarak yüklediği ve takip edilen dosyanın üzerine birleştirdiği docker-compose.override.yml içine ekleyin. Skaler anahtarlar geçersiz kılma (override) dosyası tarafından değiştirilir, böylece git içindeki hiçbir dosyanın düzenlenmesine gerek kalmaz ve git pull temiz kalır. Birleştirme kurallarının tamamı için Compose'un bir override dosyasını nasıl birleştirdiği bölümüne bakın.

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

Bu ayar yapıldığında, daha sonra çalıştırılacak bir docker compose up -d komutu, latest değerinin o gün işaret ettiği imajı çekmek yerine elinizdeki kaynaktan derleme yapacaktır. Birleştirmenin etkili olduğunu doğrulayın ve ardından etiketi kullanarak yeniden derleyin.

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

Reverse proxy ile TLS sonlandırma

Konteynerler düz HTTP üzerinden haberleşir. Ön tarafta bulunan bir bileşenin sertifikayı tutması gerekir. Caddy, Let's Encrypt üzerinden sertifikaları kendi başına talep edip yenilediği için en kısa yoldur.

gym.example.com {
    reverse_proxy 127.0.0.1:8080
}

Nginx, Traefik ve Nginx Proxy Manager aynı mantıkla çalışır. Proje dokümantasyonunda yer alan ve gelen hiçbir portun açılmasını gerektirmeyen Cloudflare Tunnel da aynı şekilde işlev görür.

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

Bu komut, herhangi bir sertifika uyarısı olmadan HTTP/2 200 döndürmelidir. Şimdi siteyi bir tarayıcıda açın ve Create profile seçeneğine dokunun. Eğer passkey istemi belirir ve ardından giriş işlemi verification failed, RP_ID veya ORIGIN hatası verirse, bu durum adres çubuğundaki URL ile eşleşmiyor demektir. .env değerini düzeltin ve konteynerlerin yeni değerleri okuması için docker compose up -d komutunu tekrar çalıştırın. Bir docker compose restart komutu, .env dosyasını yeniden yüklemez.

8080 numaralı portu genel internete kapatma

Varsayılan olarak web servisi 8080 portunu tüm arayüzlerde yayınlar; bu nedenle proxy aynı sunucuda HTTPS hizmeti verirken uygulama, genel IP adresiniz üzerinden düz HTTP ile erişilebilir durumdadır. Bir güvenlik duvarı kuralı bu durumu düzeltmez. Docker, bir portu nat tablosundaki bir DNAT kuralı ile yayınlar ve bu trafik daha sonra Docker'ın kendi kurallarının kabul ettiği FORWARD zincirinde işlenir; ufw kuralları ise INPUT yolunda kalır. Bu nedenle sudo ufw deny 8080/tcp hiçbir şeyi engellemez.

Çözüm, portu yalnızca loopback adresi üzerinden yayınlamaktır. Compose dosyası "${WEB_PORT:-8080}:${NGINX_PORT:-80}" eşlemesini yapar; bu nedenle WEB_PORT içinde ne ayarlarsanız bu eşlemenin sol tarafına yerleştirilir ve Docker'ın kısa sözdizimi burada bir ip:port çiftini kabul eder. WEB_PORT=127.0.0.1:8080 ifadesinin çalışma nedeni budur.

docker compose config
sudo ss -ltnp | grep 8080

Birleştirilmiş yapılandırmada, web servisinin ports altında host_ip: 127.0.0.1 değerini görmelisiniz. ss çıktısı 0.0.0.0:8080 yerine 127.0.0.1:8080 değerini göstermelidir. Başka bir makineden yapılan curl http://<your-vps-ip>:8080 isteği artık reddedilmeli veya zaman aşımına uğramalıdır; HTTPS ana bilgisayar adı ise çalışmaya devam etmelidir.

Profiliniz oluştuktan sonra kayıtları kapatın

Kayıt özelliği varsayılan olarak açıktır ve misafir modu etkindir. Herkese açık bir ana makine adında bu, URL'yi bulan herkesin sunucunuzda bir profil oluşturabileceği anlamına gelir. Önce kendi profilinizi kaydedin, ardından kullanıcı kimliğinizi bulun: ls data/, her kullanıcı için state-<uid>.json adında bir dosya listeler ve ihtiyacınız olan değer bu <uid> değeridir.

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

docker compose up -d komutunu tekrar çalıştırın. Ayarlar artık davet kodları oluşturup iptal edebileceğiniz bir Yönetici paneli gösterir; böylece yalnızca birlikte antrenman yaptığınız kişiler kayıt olabilir ve başkaları erişemez. openGym harici kimlik sağlayıcıları hakkında bilgi sahibi değildir, bu nedenle bu davet kodları yalnızca bu uygulamayı yönetir ve sunucudaki başka hiçbir şeyi etkilemez; çalıştırdığınız tüm servisler için kişi başına tek bir hesap tanımlamayı tercih ederseniz, Authentik'i bir forward auth proxy olarak kullanmak, openGym'in kendi passkey girişi yüklenmeden önce ana makine adını koruma altına alır.

Verilerin bulunduğu yer ve onları koruyan yedekleme

Her şey ./data dizininde bulunur ve API container'ı içine /data yoluna mount edilir. Dört tür dosya mevcuttur: db.json profilleri ve genel passkey kimlik bilgilerini tutar, state-<uid>.json bir kullanıcının rutinlerini, antrenmanlarını ve vücut ağırlığını tutar, secret oturum çerezi anahtarıdır ve vapid.json ilk çalıştırmada oluşturulan push bildirimi anahtarlarını tutar.

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

tar kopyalama işlemini yaparken dosyaların birbiriyle tutarlı kalması için önce API'yi durdurun. v1.2.7 sürümünde API, veritabanını ve antrenman durumu JSON dosyalarını geçici bir dosyaya yazar ve ardından hedef dosyanın üzerine atomik olarak yeniden adlandırır; bu nedenle canlı dosyaların üzerine doğrudan yazma yapmaz. Ardından arşivi sunucudan dışarı kopyalayın, çünkü VPS üzerinde duran bir arşiv VPS'in başına bir şey gelmesi durumunda kurtarılamaz. media/ dizinini yedekleme dışında tutun: bu dizin, medya işinin ücretsiz olarak tekrar indirebileceği 140 MB'lık egzersiz görsellerini içerir.

Geri yükleme işlemi, aynı alan adını sunan bir ana makinede aynı yola tar dosyasını açmak anlamına gelir. Telefonunuzda saklanan bir passkey, oluşturulduğu RP ID ile sınırlandırılmıştır; bu nedenle yeni bir ana makine adına geri yükleme yapmak, kimsenin giriş yapamayacağı çalışan bir veritabanı ile sonuçlanır. Alan adını koruyun veya her passkey'i yeniden kaydetmeyi planlayın. Aynı disiplin çalıştırdığınız diğer her şey için de geçerlidir ve Docker Compose yığını yedekleme ve yükseltme genel prosedürü kapsar.

Sabitlenmiş MCP sunucusu salt okunurdur ve makinenizde çalışır

MCP (model context protocol), Claude Desktop veya Cursor gibi bir istemcinin yerel bir araç sunucusuyla iletişim kurma yöntemidir. openGym, mcp/ içerisinde bir tane sunar. Bu, compose dosyasının bir parçası değildir, bir container değildir ve hiçbir portu dinlemez. İstemci onu bir alt süreç (child process) olarak başlatır ve stdio üzerinden iletişim kurar. Sabitlenmiş sunucu yalnızca yerel dosyaları okur; mevcut sunucu ise antrenman kayıtlarını eşleştirilmiş openGym API'nize gönderir.

Sunucuya değil, istemcinin çalıştığı yere kurun:

cd openGym/mcp
npm install

Ardından claude_desktop_config.json dosyasına ekleyin:

{
  "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, sunucunun bulduğu tek profili algıladığı tek kullanıcılı kurulumlarda isteğe bağlıdır. Mevcut varsayılan dalda on bir araç sunar: list_routines, get_routine, preview_session, get_week_plan, list_workouts, get_workout, get_bodyweight, estimate_1rm, muscle_balance, get_programme ve log_workout. preview_session, ilerleme politikası ve geçmişiniz planı geçersiz kıldıktan sonra bir rutin başlattığınızda uygulamanın ekrana ne getireceğini gösterir. v1.2.7 etiketi, preview_session, get_programme veya log_workout olmadan sekiz salt okunur araç sunmuştur. Bu sabitlenmiş sunucuyu kullanan bir asistan, geçen hafta ne kadar bench bastığınızı yanıtlayabilir ancak bir set kaydedemez, rutin düzenleyemez veya herhangi bir şeyi silemez. Mevcut dalda, on araç okuma yapar ve log_workout eşleştirme sonrasında antrenmanları sunucunuz üzerinden kaydeder; eşleştirme yapılana kadar kapalıdır. Bu liste, karar ajanı tasarımının sürekli geri döndüğü tek kararın kompakt bir örneğidir: sunduğunuz araçlar, bir modelin yapabileceklerinin tamamıdır ve döngüyü kendiniz yazarak ajanların nasıl çalıştığını öğrenmek, salt okunur bir araç setinin neden bir kısıtlama değil de bir tasarım tercihi olduğunu görmenin en hızlı yoludur.

İşte bir VPS kullanıcısının çözmesi gereken kısım. OPENGYM_DATA bir dosya sistemi yoludur ve verileriniz VPS üzerinde, yapay zeka istemciniz ise dizüstü bilgisayarınızdadır. Bu durumu dürüstçe ele alan iki seçenek mevcuttur.

  1. Verileri kopyalayın ve sunucuyu kopyaya yönlendirin: rsync -a --delete user@gym.example.com:/opt/opengym/data/ ~/opengym-data/, ardından OPENGYM_DATA değerini ~/opengym-data olarak ayarlayın. Sabitlenmiş sunucu yalnızca okuma yaptığı için kopyalama işleminde veri kaybı olmaz. Güncel verilere ihtiyaç duyduğunuzda rsync komutunu tekrar çalıştırın.
  2. Sunucuyu ssh üzerinden çalıştırın; command değerini ssh ve args değerini ["-T", "user@gym.example.com", "OPENGYM_DATA=/opt/opengym/data node /opt/opengym/mcp/src/index.js"] olarak ayarlayın. Bu, VPS üzerinde Node kurulu olmasını ve stdout üzerinde hiçbir çıktı vermeyen bir oturum açma işlemini gerektirir, çünkü stdout protokol kanalıdır.

Her iki seçenek de ajanın dizüstü bilgisayarınızda yaşadığını varsayar. Eğer ajanın verilerle aynı makinede çalışmasını isterseniz, OneCLI her kullanıcıya sunucuda korumalı bir ajan sağlar, böylece data/ adresine giden stdio sıçraması tekrar yerel hale gelir.

Eğer cat data/db.json komutu Permission denied döndürürse, API container'ı bu dosyaları root yetkisiyle yazmıştır ve oturumunuz bunları okuyamaz. Bunları sudo ile kopyalayın veya ana makinede sahiplik bilgilerini değiştirin. stdio yerine ağ üzerinden dinleme yapması gereken sunucular için VPS üzerinde MCP sunucuları çalıştırma bölümüne bakın.

openGym mi yoksa wger mı: hangisini çalıştırmalısınız?

wger, bu alanda yerleşik bir seçenektir ve çok daha kapsamlı bir yazılımdır. Compose yığını; nginx arkasında gunicorn ile sunulan bir Django uygulaması, PostgreSQL, Redis ve bir Celery worker içerir. Bunun karşılığında beslenme ve içerik takibi, dokümante edilmiş bir REST API, geniş bir topluluk egzersiz veritabanı ve antrenörlerin başkalarının planlarını yönetmesi için özellikler elde edersiniz.

openGym ise iki container, bir JSON dosyaları klasörü ve passkey dışında yönetilecek hesap gerektirmeyen bir yapıdır. Tüm fark bundan ibarettir. Eğer daha önce bir Chatwoot kurulumunu çalışır durumda tuttuysanız (ki burada yedekleme, uploads dizini ile birlikte bir Postgres dökümü anlamına gelir ve her sürüm yükseltmesi veritabanı migrasyonları gerektirir), wger'ın bakım konusunda sizden neler beklediğini zaten biliyorsunuz demektir.

Antrenmanla birlikte besin takibi yapmak istiyorsanız veya üzerine uygulama geliştirebileceğiniz bir API'ye ihtiyacınız varsa wger çalıştırın. Baştan sona bir öğleden sonra okunabilecek kadar küçük bir yığın ve sızdırılacak şifresi olmayan bir giriş yöntemi istiyorsanız openGym çalıştırın. Bu seçimin maliyeti olgunluktur: 19 Ağustos 2026 itibarıyla openGym'in ilk sürümü bir aylıktır, wger ise arkasında yılların sürüm geçmişini barındırır. Sürümünüzü sabitleyin, yedeklerinizi alın ve her güncellemeden önce sürüm notlarını okuyun.

Sunucunuzda neye yer ayıracağınıza hala karar veriyorsanız, 2026'da self-host etmeye değer olanlar başlıklı yazı bu konudaki ödünleşimleri ele almaktadır; bu uygulama aynı küçük VPS üzerinde yemek tarifleri için Mealie veya finans takibi için Actual Budget ile birlikte rahatlıkla çalışabilir.

Veri kaybı olmadan güncelleme

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

İstediğiniz sürümü git checkout v<new> ile kontrol edin, ardından konteynerlerin o etiket üzerinden yeniden oluşturulması için docker compose up -d --build komutunu çalıştırın. Disk üzerindeki JSON dosyalarının geri yükleme yolu tek bir tar komutuyla saniyeler içinde tamamlandığından, her zaman önce yedekleme yapılmalıdır.

FAQ

openGym telefonumda neden hiçbir zaman passkey istemi göstermiyor?

Tarayıcı, http:// üzerinde olduğunuz veya http://192.168.1.20:8080 gibi doğrudan bir IP adresi kullandığınız için kimlik bilgisi oluşturmayı reddediyor. Tarayıcılar passkey kullanımına yalnızca HTTPS kaynaklarında izin verir; localhost bu kuralın tek istisnasıdır. openGym'i gerçek bir alan adı için geçerli bir sertifikaya sahip bir reverse proxy arkasına alın, .env dosyasında RP_ID=gym.example.com ve ORIGIN=https://gym.example.com değerlerini ayarlayın ve container'ların yeni değerleri alması için docker compose up -d komutunu çalıştırın. İstemi görüyorsanız ancak giriş yaparken verification failed hatası alıyorsanız, bu iki değer adres çubuğundaki URL ile tam olarak eşleşmiyor demektir.

openGym verilerimi nerede saklıyor ve nasıl yedekleyebilirim?

Veriler, compose dosyasının yanındaki ./data dizininde, API container'ına /data olarak mount edilmiş şekilde tutulur. Bu dizin; profiller ve genel passkey kimlik bilgileri için db.json, kullanıcı başına antrenman ve vücut ağırlığı verileri için bir state-<uid>.json, oturum çerezi anahtarı için secret ve push bildirimi anahtarları için vapid.json dosyalarını içerir. Yedeklemek için önce docker compose stop api, ardından tar czf ~/opengym-$(date +%F).tar.gz data/ ve docker compose start api komutlarını çalıştırın, sonrasında arşiv dosyasını sunucudan kopyalayın. Medya işinin kendi kendine tekrar indirebileceği 140 MB'lık egzersiz görsellerini içeren media/ dizinini yedeklemenize gerek yoktur.

Claude, openGym antrenman geçmişimi okuyabilir mi?

Evet, mcp/ dizinindeki isteğe bağlı MCP sunucusu aracılığıyla okuyabilir. Sabitlenmiş v1.2.7 sürümündeki sunucu sekiz adet salt okunur araca sahiptir. Mevcut varsayılan dalda ise on bir araç bulunur: on okuma rutini (oturum önizlemeleri, haftalık planlar, antrenmanlar, vücut ağırlığı, tahmini tek tekrar maksimumu, kas dengesi ve programlar) ve eşleşme sonrası sunucunuz üzerinden antrenman yazmanızı sağlayan log_workout aracı. Bu bir container değildir ve herhangi bir port açmaz: istemciniz onu stdio üzerinden başlatır ve okuma araçları OPENGYM_DATA konumundaki JSON dosyalarına doğrudan erişir. Bu bir dosya sistemi yolu olduğu için, openGym'i bir VPS üzerinde çalıştırıyorsanız ya data/ dizininin bir kopyasını istemcinin çalıştığı makineye senkronize etmeniz ya da istemci yapılandırmasından ssh aracılığıyla sunucuyu çağırmanız gerekir.

openGym mi yoksa wger mi self-host etmeliyim?

Antrenman günlüğünüzün yanı sıra beslenme takibi istiyorsanız veya üzerine inşa edebileceğiniz dokümante edilmiş bir REST API arıyorsanız wger'i seçin. wger daha büyük bir yığın çalıştırır: nginx arkasında gunicorn ile Django, PostgreSQL, Redis ve Celery worker. Yalnızca iki container, cat ile okuyabileceğiniz JSON dosyaları ve yönetilecek parola gerektirmeyen passkey girişi istiyorsanız openGym'i seçin. 19 Ağustos 2026 itibarıyla openGym'in ilk etiketli sürümü henüz bir aylıktır; bu nedenle her güncellemeden önce bir git etiketi kontrol edin ve data/ dizinini yedekleyin.

Bu yazı işinize yaradı mı?