メインコンテンツへスキップ
Enclave

Docker Compose ワンコマンドデプロイ

リポジトリをクローン → .env をコピーして記入 → docker compose up -d。3 ステップでメインアプリと Core API がまとめて起動します。ヘルスチェック内蔵、データはホストの ./data ディレクトリに保存。これが推奨のセルフホスティング手順です。

  1. 1.依存関係と API キーを準備する

    マシンに Docker 24+ と Docker Compose v2 をインストールします。さらに LLM ゲートウェイの API キーを 1 つ用意——OpenAI 互換ゲートウェイなら何でも構いません(DeepSeek、OpenRouter、Groq、OpenAI、ローカルの Ollama)。選び方は「BYOK とモデルプロバイダーの選定」を参照。

  2. 2.リポジトリをクローンして .env を設定する

    git clone 後に cp api/.env.example api/.env を実行し、api/.env で最低限これらを記入:LLM ゲートウェイ 3 点セット(DEEPSEEK_API_KEY / OPENAI_BASE_URL / AI_MODEL)、ADMIN_SECRET、JWT_SECRET、USER_API_KEY_ENCRYPTION_SECRET(互いに異なる長いランダム文字列 3 本。openssl rand -hex 32 で生成可)、そして CORS_ALLOWED_ORIGINS と PUBLIC_API_BASE_URL(あなたのアクセスアドレス、/api は付けない)。完全な変数の説明は「環境変数リファレンス」へ。

  3. 3.起動

    リポジトリルートで docker compose up -d を実行します。デフォルトで 2 つのコンテナが起動:web(静的フロントエンド、APP_PORT で公開、デフォルト 80)と api(Core API、PORT で公開、デフォルト 3000)、どちらもヘルスチェック付き。web コンテナ内の nginx が /api、/socket.io、/health を api へ転送済みなので、外から見れば単一の入り口です。バックエンドだけ起動したい場合は docker compose up -d api。SQLite データはホストの ./data/database.sqlite に保存されます。

  4. 4.確認

    curl http://localhost/healthz と curl http://localhost/health がどちらも 200 を返すはずです。その後ブラウザでメインアプリを開いて最初のアカウントを登録——最初にサインインしたユーザーがワールドオーナーになります。

関連する質問

  • Enclave はセルフホストできますか?難しいですか?
    できます。難易度は普通の web サービスを動かすのと同程度です。docker compose を使ったことがあれば、3 ステップで自分のインスタンスを持てます。リポジトリをクローンし、.env をコピーし、docker compose up するだけ。API・フロントエンド・データベース・ベクトルインデックスはすべて自分のマシン上で動きます。
  • Enclaveをセルフホストするには何が必要ですか?GPUは必要ですか?
    必ずしもGPUは必要ありません。クラウドモデルAPI(OpenAI、Anthropicなど)を使うなら、Dockerが動く普通のサーバーや家庭用マシンで十分です——推論はクラウドで行われ、本機はアプリとデータベースを動かすだけです。ローカルモデル(Ollama / vLLM)でオフライン推論をしたい場合にのみ、相応のVRAMと計算リソースが必要になります。
  • Enclaveは完全オフラインで動かせますか?
    できます。モデル層をローカルのOllama / vLLMに切り替え、現実世界との同期をオフにすれば、システム全体は外部へのリクエストを一切送らなくなり、あなた自身のマシン上で完全にオフラインで動作します——いかなる約束にも依存しない、最も強力なプライバシー保証です。

関連コンテンツ

セルフホスティングドキュメントへ戻る
共有XTelegramLINEWeibo
Docker Compose ワンコマンドデプロイ · Enclave