この記事は、前回の記事の続きです。前回は CodeX CLI を WSL 上で動かし、Podman による動作検証環境を整備しました。今回はその環境をベースに Supabase のセルフホスト環境を構築し、CodeX CLI からの検証にも活用できる形にしていきます。

前提条件

Windows 11 + WSL2 (Ubuntu 22.04 以降推奨)
CodeX CLI サンドボックスは full-access モードで起動
Podman + podman-compose がインストール済み
rootless Podman の設定（subuid/subgid, systemd 有効化, podman.socket）が済んでいる

1. Supabase ソースの取得

git clone --depth 1 https://github.com/supabase/supabase
mkdir supabase-project
cp -rf supabase/docker/* supabase-project
cd supabase-project

2. 環境変数ファイルの準備

cp .env.example .env

必ず以下を修正してください：

POSTGRES_PASSWORD（強固なパスワードに変更）
JWT_SECRET（40文字程度のランダム文字列）
SITE_URL（例: http://localhost:8000）
DASHBOARD_USERNAME / DASHBOARD_PASSWORD（初期値から変更）

JWT シークレットの生成例：

echo "JWT_SECRET=$(openssl rand -hex 20)" >> .env

Podman のソケット指定を追加：

echo "DOCKER_SOCKET_LOCATION=/run/user/$(id -u)/podman/podman.sock" >> .env
echo 'export DOCKER_HOST=unix:///run/user/$(id -u)/podman/podman.sock' >> ~/.bashrc
source ~/.bashrc

3. コンテナの起動

podman-compose pull
podman-compose up -d

状態確認：

podman-compose ps

初回はイメージ取得と初期化で数分かかることがあります。STATUS が healthy になるのを確認してください。

4. アクセス確認

Studio (ダッシュボード): http://localhost:8000
REST API: http://localhost:8000/rest/v1/
Auth API: http://localhost:8000/auth/v1/
Storage API: http://localhost:8000/storage/v1/
Functions (サンプル): http://localhost:8000/functions/v1/hello

5. CodeX CLI での活用例

Supabase セルフホスト環境を立ち上げることで、CodeX CLI のサンドボックスから次のような検証が可能になります。

API エンドポイントを叩くスクリプト生成
CodeX CLI に API 仕様を伝え、REST / Auth / Storage API を呼び出すコードを生成させて実行できます。
DB スキーマの変更を検証
Postgres 接続設定を渡し、SQL マイグレーションスクリプトを生成・適用することで DB の変更を素早く試せます。
フロントエンドとの統合確認
Supabase Auth を利用するアプリの雛形を CodeX CLI に作らせ、ローカル Supabase と接続検証が可能です。

このように 「AIエージェント × ローカル Supabase」 の組み合わせで、迅速に API / DB / Auth の動作を試すことができます。

6. 更新・停止

更新

podman-compose pull
podman-compose up -d

停止

podman-compose down

サービス再起動

podman-compose restart functions --no-deps

まとめ

full-access モードで起動しないと rootless Podman が動作しない
.env のシークレット類は必ず初期値から変更する
podman-compose で Supabase セルフホスト環境を構築可能
CodeX CLI から API や DB の検証タスクを自動化できる