Olivares AI をセルフホストする

Olivares AI は セルフホスト・ファースト です。製品全体が Web UI を埋め込んだ 1 つの静的バイナリであるため、最も単純なデプロイは単一ファイルで済みます。マルチノードや本番向けには Compose や Kubernetes の経路も用意されています。どの経路も同じセキュアなデフォルト設定 — デフォルト認証情報なし、ワンタイムのセットアップトークン、TLS をデフォルトで有効化 — を共有します。必須のテレメトリはなく、デフォルトではコントロールプレーンからのエグレスもありません。あなたの境界を越えるのは、あなたがそのように設定したものだけです。具体的には、あなたのモデル API への呼び出し、接続した SIEM／Webhook 出力、用意した場合の外部埋め込みプロバイダーです。

このガイドはデプロイの 意思決定ページ です — 選択肢とそのセキュアなデフォルト設定を一目で把握できます。各シナリオの手順を追ったインストールについては、getting-started チュートリアルがすべての経路をエンドツーエンドで解説しています: 単一ノード (systemd) · Docker Compose · Kubernetes/Helm · air-gapped (エアギャップ)。まず成果物を暗号的に検証するにはダウンロードしたものを検証するを、ネットワーク非接続のサイトについてはエアギャップ環境でインストールするを参照してください。

セキュアなデフォルト設定 (すべての経路)

デフォルト	動作
認証情報	なし。初回起動時にワンタイムかつ単一利用のセットアップトークン (`olst_…`) を表示する。これを使って最初の管理者を作成する。
TLS	デフォルトで有効。`--insecure` (平文) は localhost での開発専用。
バインド	バイナリはデフォルトでループバックにバインドする。公開は意図的に行うこと。
ライセンス	オープン（AGPL）バイナリでは、ライセンスはオフラインで検証され（Ed25519）、証明（attestation）にのみ用いられる。オープン製品をゲートしたり劣化させたりすることは決してなく、この点は変わらない。商用アドオンは、サブスクリプションによるエンタープライズリポジトリへのアクセスとして提供される、支払われた期間に対する権利である（SUSE/Novell モデル）。アドオンを取得し、その更新（セキュリティ更新を含む）を受け取るには、この権利が必要となる。エアギャップ環境への提供も SUSE と同じ方式で行われ、この権利が引き続き適用されるローカルミラーを経由する。
テレメトリ送信	オフ。エンジンは起動時に必須の外向き通信を一切行わない。

選択肢 1 — 単一バイナリ

1 つの静的成果物 (純 Go の SQLite ストア、つまり C ツールチェーン不要) をビルドして実行します:

task build                      # compiles ./bin/olivares with the web embedded
./bin/olivares serve \
  --listen 127.0.0.1:8443 \
  --grpc-listen 127.0.0.1:8444 \
  --data-dir /var/lib/olivares

初回起動時、エンジンはセットアップバナーを表示します:

=== FIRST-BOOT SETUP ===
No accounts exist yet. Open the console and create the first administrator
with this one-time token — setup also creates your first organization and
makes that administrator its owner:

  Console:  https://127.0.0.1:8443
  Token:    olst_…

The console serves HTTPS with a self-signed certificate on first boot — your
browser will warn once; that is expected. The token is shown ONCE and is
single-use. Prefer the API? POST /v1/setup {"token":"…","email":"…",
"password":"…"} — add "organization":"…" to name it (default: "Default
Organization"). The reply carries the new organization's tenant_id.
========================

最初の管理者を作成し、ログインします:

curl -fsS -X POST https://localhost:8443/v1/setup \
  -H 'Content-Type: application/json' \
  -d '{"token":"<olst_ token>","email":"you@example.com","password":"<strong-password>"}'

curl -fsS -X POST https://localhost:8443/v1/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com","password":"<strong-password>"}'

データディレクトリには SQLite データベース、監査署名鍵、TLS マテリアルが格納されます。バックアップを取り、保護してください。

選択肢 2 — Docker Compose (単一ノード、SQLite)

リポジトリには Compose スタックが同梱されています:

docker compose -f deploy/compose/docker-compose.yml up -d

# Read the one-time first-boot setup token from the logs:
docker compose -f deploy/compose/docker-compose.yml logs olivares | sed -n '/FIRST-BOOT SETUP/,/========================/p'

# Then open https://localhost:8443 (self-signed TLS by default)

マルチテナントの Postgres バックエンドを使う場合は、パスワードを設定して Postgres オーバーライドを重ねます:

cp deploy/compose/.env.example deploy/compose/.env     # set the two passwords
docker compose -f deploy/compose/docker-compose.yml \
               -f deploy/compose/docker-compose.postgres.yml up -d

選択肢 3 — Kubernetes (Helm)

署名済みの Helm チャートは、control plane を コア StatefulSet (単一ライター。そのデータディレクトリには監査署名鍵と TLS マテリアルが格納される) としてデプロイし、分散トポロジー向けには、観測結果を gRPC + mTLS 経由でコアにプッシュする コレクター DaemonSet をデプロイします。リリース時にはチャートが OCI レジストリに公開され cosign で署名されるため、インストール時に検証し、ダイジェストでピン留めできます。 (最初のリリースはまだ ドラフト です。chart-v* タグが作成されるまでレジストリのパスは空なので、以下のコマンドはリリースが公開された後に使う経路です。)

helm install olivares \
  oci://ghcr.io/olivaresai/charts/olivares \
  --version <chart-version> \
  --set image.repository=docker.io/olivaresai/olivares \
  --set image.digest=<sha256-digest>

公開チャートは GPG ではなく OCI マニフェスト上で cosign 署名されています。リリースパイプラインは .prov レイヤーを出力しないため、helm --verify では検証できません。release-chart.yml@refs/tags/chart-v* の識別子に対して cosign verify で検証してください — deploy/helm/README.md を参照。

チャートは Docker Hub (docker.io/olivaresai/olivares) からコンテナイメージを取得します。同じイメージは ghcr.io/olivaresai/olivares にもあり、ダイジェストは同一です。Docker Hub の匿名プルのレート制限が障害になる場合は image.repository をそちらに向けてください（ghcr.io は公開イメージに制限を課しません）。チャート 成果物自体は oci://ghcr.io/olivaresai/charts/olivares に残ります。

常に ダイジェストで デプロイし、可変タグは決して使わないでください。完全にネットワーク非接続のクラスターでは、まずバンドルをミラーします — エアギャップインストールを参照してください。

トポロジーを選ぶ

トポロジー	用途	ストア	イベントバス
単一バイナリ	単一ノード、ラボ、小規模 estate、エアギャップ	SQLite (埋め込み)	インプロセス
分散	マルチホスト、スケール、マルチテナント	Postgres + RLS	インプロセス + NATS ブリッジ (`OLIVARES_BUS_CONFIG`。ノード間配信は正直なところ最大 1 回 (at-most-once))
エアギャップ	egress が許可されない	SQLite または Postgres	インプロセス (境界内であれば NATS ブリッジは任意)

data-plane (コレクター) は常に自分のインフラ上で動作します — control plane だけがホスト先を選べる対象です。トレードオフについてはアーキテクチャ概要が説明しています。

実際のソースを接続する

新規インストールの estate は空です。実際のソース (Postgres pgAudit、CloudTrail、エージェントからの OpenTelemetry、eBPF) を結線して access map を埋めましょう — ソースを接続すると Claude Code を接続するを参照してください。設定の全体像は設定リファレンスを参照してください。