セルフホスティングドキュメント
Enclave を丸ごと自分のマシンで動かす:サービス 2 つ、SQLite ファイル 1 つ、外部依存ゼロ。アーキテクチャから公開まで、バックアップから自前のデスクトップインストーラー作成まで、運用者に必要なものはすべてここに。日常の使い方の疑問はヘルプセンターへ。
デプロイ
セルフホスティングの Enclave はサービス 2 つだけ:静的フロントエンド(メインアプリ)+ Core API(NestJS)、データは SQLite ファイル 1 つ——Postgres、Redis、メッセージキューなどの外部依存はありません。各部分が何か、データがどこにあるか、運用の入り口がどこかを解説します。
リポジトリをクローン → .env をコピーして記入 → docker compose up -d。3 ステップでメインアプリと Core API がまとめて起動します。ヘルスチェック内蔵、データはホストの ./data ディレクトリに保存。これが推奨のセルフホスティング手順です。
Node.js 20+ と nginx があれば動きます:バックエンドは npm ci + build 後に node か pm2 で常駐させ、フロントエンドは静的ファイルにビルドして nginx に渡します。リポジトリ付属の nginx 設定テンプレートはプレースホルダー 2 つを置換すればそのまま使えます。
証明書付きの nginx 1 台で公開ドメインをメインアプリにリバースプロキシすれば公開完了。ハマりやすい点は 3 つ:WebSocket には Upgrade ヘッダーが必須、CORS と公開アドレスの env を 2 つ更新、X-Admin-Secret ヘッダーは明示的に透過。
運用
api/.env は 4 グループで理解:LLM ゲートウェイ 3 点セット、サーバーシークレット 3 本、ネットワークとパス、オプションのメディアとメール。知っておくべき歴史的な命名が 1 つ:DEEPSEEK_API_KEY は実は汎用ゲートウェイキーで、OpenAI 互換ゲートウェイなら何でもここに入れます。
データの本体は ./data ディレクトリ内の SQLite ファイル 1 つとメディアディレクトリ:バックアップ = コピー、移行 = 新しいマシンへコピー、アップグレード = git pull 後にコンテナを再ビルド。厳密なバックアップは sqlite3 の .backup コマンドで。メジャーアップグレードの前には必ず一度バックアップを。
Enclave はあなたの AI キーを預かりません:セルフホスティングのクラウドコストはほぼゼロで、モデル費用は選んだゲートウェイに直接支払います。任意の OpenAI 互換ゲートウェイが env 3 行で接続でき、ゲートウェイを替えてもチャット履歴や関係性は一切失われません。