SSD Nodes Learn Hosting plans →
ガイド Matt Connor著者 Matt Connor ・更新日 2026-11-06

openGymをVPSに自己ホストする方法

Docker ComposeでopenGymをVPSに構築します。v1.2.7の固定、初回Passkey前のTLS、JSONデータの保存場所、任意のMCP serverまで確認できます。

自己ホストした openGym で得られるもの

openGym は、リポジトリを clone し、.env の 2 行を編集して、TLS (transport layer security) を終端するリバースプロキシの背後で docker compose up -d --build を実行することで自己ホストできます。openGym は、週間プラン、ガイド付きワークアウト、各セットの記録、経時的な体重を管理するジム・体重トラッカーです。ライセンスは AGPL-3.0 で、すべてのデータをディスク上のプレーンな JSON ファイルに保存するため、データベースサーバーを実行する必要はありません。

構成は、長時間稼働する 2 つのコンテナ、React ビルドを配信する nginx コンテナ、API を保持する Node コンテナで成り立ちます。これに加えて、初回起動時に約 140 MB のエクササイズ画像と GIF をダウンロードする one-shot ジョブがあります。

このプロジェクトの README は、公開サーバーにデプロイする人向けに、2 つの点を明記していません。Passkey ログインはホスト名に紐付くため、初回ログインの後ではなく、前にドメインとその証明書を用意する必要があります。また、固定された v1.2.7 tag のオプションの MCP server は読み取り専用で、stack 内ではなく AI client が実行されるマシン上で動作します。そのため、データが VPS 上にある場合に必要な作業が変わります。現在の MCP server は、サーバーとのペアリング後にワークアウトを記録する機能にも対応しています。

openGym はまだ新しいソフトウェアです。最初の tagged release である v1.0.0 は 20 July 2026 付けで、v1.2.7 は 18 August 2026 にリリースされました。最初の 1 か月で 13 個の tag が作成され、2026 年 10 月 9 日までに v1.4.0 を含めて 34 個になっています。開発は現在も活発に進んでいるため、default branch のその時点の内容を使うのではなく、release tag を checkout してください。

最初のログイン前にドメインを決める

openGym へのサインインには Passkeys を使用します。Passkey は relying party ID(RP ID)に関連付けられます。RP ID は credential を作成したドメインです。また、ブラウザーが Passkey を作成できるのは HTTPS 経由だけです。唯一の例外は localhost です。

この制約は、スマートフォンで操作するときに問題になります。別のデバイスから http://203.0.113.10:8080 を開いても、Passkey のプロンプトは表示されません。ブラウザーが、通常の HTTP origin や IP アドレスだけのアドレスで credential を作成しないためです。プロジェクトのトラブルシューティングのメモにも同じことが記載されています。プロンプトが表示されない場合は、http:// または IP アドレスを使用しています。

さらに、RP ID は登録済みのすべての credential に組み込まれています。後から RP_ID を変更すると、ユーザーのデバイスに保存された Passkey と一致しなくなり、誰もサインインできなくなります。先にホスト名を決め、DNS を VPS に向け、誰かが Create profile をタップする前に証明書を有効にしてください。

Docker Compose で openGym をデプロイする

Compose ファイルは ./data と ./media を自身からの相対パスで bind mount するため、clone 先のディレクトリ自体がデータベースになります。永続性のある場所に配置してください。

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 の clone URL が記載されています。2026 年 11 月 4 日時点で、このリポジトリは解決でき、プロジェクトのホームとして説明されています。最初のビルドの前に tag を checkout してください。default branch はこのガイドで説明するバージョンより先に進んでおり、その branch では exercise のアニメーションが image に含まれ、以下の media job はすでに存在しません。pinning に関するセクションで、その理由を説明します。

.env を編集します。VPS では、重要なのは 3 行です。

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

RP_ID はホスト名だけを示し、ORIGIN は scheme を含む完全な URL です。アドレスバーに表示されるアドレスと完全に一致させる必要があります。一致しないと、verification failed でログインに失敗します。WEB_PORT の値については、port 8080 を非公開にするセクションで説明します。

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

docker compose ps --all では、web と api が running で、media が code 0 で exited になっていることを確認します。--all flag は必ず付けてください。これがないと Compose は running 中の container だけを一覧表示するため、完了した media job は表示されません。この終了は正しい動作です。media job は一度だけダウンロードを実行するため、restart: "no" しています。ログの末尾には ✓ Exercise media ready で始まる行があり、ls media/img | wc -l は 0 ではなく 1,324 を出力するはずです。これは、upstream の exercise dataset に 2026 年 10 月 9 日時点で含まれる thumbnail 数です。ディレクトリが空の場合はダウンロードに失敗しています。その場合、アプリは画像が空白の exercise card を表示します。

--build flag は必ず付けてください。この tag の compose ファイルは、ghcr.io 上の prebuilt image を latest tag で指定しています。これらの image は 2026 年 10 月 18 日時点でも再公開されていますが、latest は最新の release に追従します。そのため、docker compose pull を実行すると、checkout したソースより新しいコードが実行されます。両方の service には build セクションがあり、--build はその代わりに checkout したソースから build します。Compose 自体が初めての場合は、まず VPS での Docker Compose を読み、その後ここに戻ってください。

バージョンを固定する。プロジェクトが新しいため

レジストリには再びバージョン付きイメージがありますが、v1.2.7 の compose ファイルは依然として latest を要求します。2026 年 11 月 4 日時点で、latest は 2026 年 11 月 3 日にリリースされた 1.4.4 を指しています。固定する対象はディスク上の checkout です。これによって、コンテナに入るアプリケーションのバージョンが決まります。

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

git status は現在、そのタグで detached HEAD になっています。これはサーバーで必要な状態です。別のタグを checkout するまで、現在の状態は変わりません。

v1.2.7 はこのガイドの作成時に基準としたリリースであり、現在は最新ではありません。後続のリリースではデプロイ自体が変更されています(default branch では media job が削除されています)。そのため、固定先を変更する前に release notes を読み、compose ファイルを比較してください。v1.4.2 と v1.4.3 の release notes にはセキュリティ修正も記載されており、プロジェクトは self-host する利用者に更新を求めています。

次に、Compose がレジストリへアクセスしないようにします。docker-compose.override.yml に次の内容を記述します。このファイルは Compose が自動的に読み込み、tracked file に重ねてマージします。スカラー値のキーは override 側で置き換えられるため、git 内のファイルを編集する必要はなく、git pull もクリーンな状態に保てます。完全なマージ規則については、Compose が override file をマージする方法 を参照してください。

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

これで、後から実行する docker compose up -d は、その時点で latest が指しているイメージを pull するのではなく、手元の source からビルドします。マージが反映されたことを確認してから、そのタグで再ビルドします。

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

TLS をリバースプロキシで終端する

コンテナは平文の HTTP で通信します。証明書は前段のコンポーネントで保持する必要があります。最短の方法は Caddy です。Caddy は Let's Encrypt から証明書を自動的に取得して更新します。

gym.example.com {
    reverse_proxy 127.0.0.1:8080
}

nginx、Traefik、Nginx Proxy Manager も同じ方式で動作します。Cloudflare Tunnel も同様です。プロジェクトのドキュメントに記載されており、受信ポートを開放する必要もありません。

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

これにより、証明書の警告なしで HTTP/2 200 が返るはずです。次にブラウザーでサイトを開き、Create profile を選択します。パスキーのプロンプトが表示された後、ログインで verification failed と表示された場合は、RP_ID または ORIGIN がアドレスバーの URL と一致していません。.env を修正し、docker compose up -d を再度実行します。これによりコンテナが再作成され、新しい値が読み込まれます。docker compose restart では .env は再読み込みされません。

パブリックインターネットからポート 8080 へのアクセスを遮断する

デフォルトでは、Web サービスがすべてのインターフェースで 8080 を公開します。そのため、プロキシが同じホストで HTTPS を提供していても、公開 IP アドレス経由で平文 HTTP のアプリにアクセスできます。ファイアウォールルールだけでは、この状態は解消できません。Docker は nat テーブルの DNAT ルールでポートを公開し、そのトラフィックは FORWARD チェーンで処理されます。ここでは Docker 自身のルールがトラフィックを許可します。一方、ufw のルールは INPUT 経路にあります。したがって、sudo ufw deny 8080/tcp は何も遮断しません。

対処方法は、loopback アドレスだけで公開することです。compose ファイルでは "${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

マージ後の設定では、Web サービスの 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 を知っている人なら誰でもサーバー上にプロフィールを作成できます。まず自分のプロフィールを登録し、ユーザー ID を確認します。ls data/ にはユーザーごとに state-<uid>.json というファイルが表示され、その <uid> が必要な値です。

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

docker compose up -d を再度実行します。Settings に Admin ダッシュボードが表示され、招待コードを生成・無効化できるようになります。これにより、トレーニング相手だけが登録でき、それ以外の人は登録できなくなります。openGym は外部の ID プロバイダーに対応していません。そのため、これらの招待コードが制御するのはこのアプリだけであり、サーバー上の他のサービスには影響しません。実行するすべてのサービスでユーザーごとに 1 つのアカウントを使いたい場合は、forward auth proxy として Authentik を前段に配置することで、openGym 独自の passkey ログインが読み込まれる前にホスト名へのアクセスを制御できます。

データの保存場所と、それを保護するバックアップ

すべてのデータは ./data ディレクトリにあり、API コンテナ内の /data にマウントされています。ファイルは4種類あります。db.json にはプロファイルと公開パスキー認証情報が保存され、state-<uid>.json には1ユーザー分のルーティン、ワークアウト、体重が保存されます。secret はセッション Cookie の暗号鍵で、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のエクササイズ画像で、media job が無料で再ダウンロードできます。

復元するには、同じドメインを提供しているホスト上で、同じパスに展開します。スマートフォンに保存されたパスキーは、作成時の RP ID に紐付いています。そのため、新しいホスト名へ復元すると、データベースは使用できても誰もサインインできません。ドメインを維持するか、すべてのパスキーを再登録する計画を立ててください。同じ方針は、運用する他のすべてのものにも適用されます。一般的な手順については、Docker Compose スタックのバックアップとアップグレードを参照してください。

ピン留めされた MCP server は読み取り専用で、マシン上で実行されます

MCP (model context protocol) は、Claude Desktop や Cursor などのクライアントがローカルのツールサーバーと通信するための仕組みです。openGym には mcp/ に 1 つ含まれています。compose file の一部ではなく、container でもありません。また、どの port も listen しません。クライアントが child process として起動し、stdio 経由で通信します。ピン留めされた server はローカルファイルを読み取るだけです。一方、現在の server は、ペアリング済みの openGym API に workout の書き込みも送信します。

クライアントを実行する場所にインストールします。server にはインストールしません。

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 は、server が検出した唯一の profile を使用する単一ユーザー構成では省略できます。現在の default branch では、11 個の tool が公開されます。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 を使うと、routine の開始時にアプリが実際に画面へ表示する内容を確認できます。これは progression policy と履歴によって plan が上書きされた後の内容です。v1.2.7 tag では、preview_session、get_programme、log_workout を含まない 8 個の読み取り専用 tool が提供されていました。そのピン留めされた server を使う assistant は、先週どの種目を bench したかには答えられますが、set の記録、routine の編集、削除はできません。現在の branch では、10 個の tool が読み取りを行い、log_workout がペアリング後に server 経由で workout を保存します。ペアリングするまで無効です。この一覧は、agent の設計で繰り返し登場する重要な判断を簡潔に示しています。つまり、公開する tool が model に可能な操作のすべてを決めます。agent の仕組みを自分で loop を書いて学ぶことが、読み取り専用の tool set が制限ではなく設計上の選択である理由を理解する最短の方法です。

VPS の利用者が解決する必要があるのは、次の点です。OPENGYM_DATA は filesystem path ですが、データは VPS 上にあり、AI client は laptop 上にあります。この構成には、実態に即した 2 つの方法があります。

  1. データを取得してコピーを参照する方法です。rsync -a --delete user@gym.example.com:/opt/opengym/data/ ~/opengym-data/ を実行し、OPENGYM_DATA を ~/opengym-data に設定します。ピン留めされた server は読み取り専用なので、コピーしても失われるものはありません。最新の数値が必要なときに rsync を再実行します。
  2. ssh 経由で server を実行する方法です。command を ssh に設定し、args を ["-T", "user@gym.example.com", "OPENGYM_DATA=/opt/opengym/data node /opt/opengym/mcp/src/index.js"] に設定します。この方法では VPS に Node がインストールされている必要があります。また、stdout に何も出力しない login が必要です。stdout は protocol channel として使われるためです。

どちらの方法も、agent 自体が laptop 上で動作することを前提としています。データと同じ box 上で agent を実行したい場合は、OneCLI により、各ユーザーが server 上で sandbox 化された agent を利用できます。その場合、data/ までの stdio 経路も再びローカルになります。

cat data/db.json が Permission denied を返す場合、API container がそれらのファイルを root として作成しており、login ユーザーが読み取れません。sudo でコピーするか、host 上で所有者を変更します。stdio ではなく network 経由で listen する server については、VPS 上で MCP server を実行するを参照してください。

openGym と wger: どちらを運用すべきか

この分野では wger が定評のある選択肢で、ソフトウェアの規模も大きくなっています。compose stack では、nginx の背後で Django application を提供する gunicorn、PostgreSQL、Redis、Celery worker が動作します。その代わり、栄養と食材の記録、文書化された REST API、大規模な運動データベース、他人のトレーニング計画を管理する trainer 向けの機能を利用できます。

openGym は 2 つの container、JSON ファイルのフォルダー、そして passkey 以外に管理が必要なアカウントがない構成です。違いはそれだけです。Chatwoot のインストールを運用し続けたことがあるなら、バックアップでは uploads directory と併せて Postgres dump を取得し、バージョン更新のたびに database migration が実行される構成が wger の保守に求められる形だと分かるはずです。

トレーニングと併せて食事も記録したい場合、または連携先として利用する API が必要な場合は wger を運用してください。午後のうちに全体を読み通せるほど小さな stack と、漏えいするパスワードのないログインを求める場合は openGym を運用してください。この選択の代償は成熟度です。2026 年 8 月 19 日時点で、openGym の最初の release から 1 か月しか経っていません。一方、wger には何年分もの release 実績があります。バージョンを固定し、バックアップを保持し、更新前に release notes を確認してください。

まだサーバー上で何を運用する価値があるか決めていない場合は、2026 年に self-hosting する価値があるものでトレードオフを確認できます。このアプリは、同じ小規模な 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>で使用するリリースをチェックアウトし、docker compose up -d --buildを実行して、そのタグからコンテナを再ビルドします。毎回、最初にバックアップを実行します。ディスク上の JSON ファイルを復元する手順は、tarコマンド1つで済み、数秒で完了するためです。

FAQ

openGym でスマートフォンにパスキーのプロンプトが表示されないのはなぜですか?

ブラウザーは、http:// または http://192.168.1.20:8080 のような bare IP address 上にいるため、credential の作成を拒否しています。ブラウザーでパスキーを使用できるのは HTTPS origin 上だけで、localhost が唯一の例外です。openGym を実在する hostname 用の実証明書を保持する reverse proxy の背後に置き、.env で RP_ID=gym.example.com と ORIGIN=https://gym.example.com を設定してから、docker compose up -d を実行してコンテナーに新しい値を読み込ませます。プロンプトは表示されるものの、ログイン時に verification failed と表示される場合は、その 2 つの値がアドレスバーの URL と完全には一致していません。

openGym はデータをどこに保存しますか。また、どのようにバックアップしますか?

compose file の隣にある ./data directory に保存し、API container には /data として mount されます。ここにはプロフィールと公開パスキー credential 用の db.json、workout と体重用のユーザーごとの state-<uid>.json、session cookie key 用の secret、push notification key 用の vapid.json が含まれます。docker compose stop api、続いて tar czf ~/opengym-$(date +%F).tar.gz data/、さらに docker compose start api を実行してバックアップし、archive をサーバー外へコピーします。media/ は除外してください。これは 140 MB の exercise image であり、media job が自動的に再ダウンロードします。

Claude は openGym の workout 履歴を読み取れますか?

はい。mcp/ directory にあるオプションの MCP server を使用できます。固定された v1.2.7 server には read-only tool が 8 個あります。current default branch には 11 個の tool があり、10 個の read routine、session preview、week plan、workout、体重、estimated one-rep max、muscle balance、programme を扱います。log_workout は pairing 後に、あなたの server 経由で workout を書き込みます。これは container ではなく、port も開きません。client が stdio 経由で起動し、read tool は OPENGYM_DATA の JSON file に直接アクセスします。これは filesystem path なので、openGym を VPS で実行する場合は、data/ の copy を client を実行する machine に同期するか、client config から ssh 経由で server を呼び出します。

openGym と wger のどちらを self-host すべきですか?

トレーニングログと併せて食事・栄養を記録したい場合、または構築の基盤となる documented REST API が必要な場合は wger を選びます。wger は、nginx の背後で gunicorn 上の Django、PostgreSQL、Redis、Celery worker を動かす、より大きな stack です。2 つの container、cat で読み取れる JSON file、管理する password が不要な passkey login を求める場合は openGym を選びます。2026 年 8 月 19 日時点で、openGym の最初の tagged release は公開から 1 か月しか経過していません。そのため、各 update の前に git tag を checkout し、data/ をバックアップしてください。

この記事は役に立ちましたか?