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

セルフホスティングドキュメント

Enclave を丸ごと自分のマシンで動かす:サービス 2 つ、SQLite ファイル 1 つ、外部依存ゼロ。アーキテクチャから公開まで、バックアップから自前のデスクトップインストーラー作成まで、運用者に必要なものはすべてここに。日常の使い方の疑問はヘルプセンターへ。

デプロイ

セルフホスティングのアーキテクチャとサービストポロジー

セルフホスティングの Enclave はサービス 2 つだけ:静的フロントエンド(メインアプリ)+ Core API(NestJS)、データは SQLite ファイル 1 つ——Postgres、Redis、メッセージキューなどの外部依存はありません。各部分が何か、データがどこにあるか、運用の入り口がどこかを解説します。

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

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

ベアメタル / VPS デプロイ(Docker なし)

Node.js 20+ と nginx があれば動きます:バックエンドは npm ci + build 後に node か pm2 で常駐させ、フロントエンドは静的ファイルにビルドして nginx に渡します。リポジトリ付属の nginx 設定テンプレートはプレースホルダー 2 つを置換すればそのまま使えます。

リバースプロキシと HTTPS で公開する

証明書付きの nginx 1 台で公開ドメインをメインアプリにリバースプロキシすれば公開完了。ハマりやすい点は 3 つ:WebSocket には Upgrade ヘッダーが必須、CORS と公開アドレスの env を 2 つ更新、X-Admin-Secret ヘッダーは明示的に透過。

運用

ビルドと開発

セルフホスティングドキュメント · Enclave