コンテンツにスキップ
Olivares AI docs

設定リファレンス

0.1 以降、KMS で封印した署名鍵と設定ファイル（CMEK）には Business バイナリが必要です。オペレーターが用意した署名鍵と keys status は Community に残ります。保管の宣言 BYOK（OLIVARES_KEY_CUSTODY=byok）と HYOK（OLIVARES_LEDGER_CUSTODY=hyok）、ホスト外でのチェックポイント署名（OLIVARES_LEDGER_SIGNER）、olivares audit key-transition には Business バイナリが必要で、Community は終了コード 9 で拒否します。Community は CMEK が設定された環境で、ストアを開く前や鍵を作成する前に処理を拒否します。dr backup と keys unseal には、お客様の KMS と Business を使用してください。復旧に有効なライセンスは不要です。

このページは、コントロールプレーンエンジン — olivares という名前の単一 Go バイナリ — の設定サーフェスを文書化します。serve サブコマンドが受け付けるフラグ、エンジンが起動時に読み取る環境変数、ストアとポリシー決定点がどのように選択されるか、そして設定がまったくない状態で有効になるセキュアなデフォルトをカバーします。

ここに列挙されたすべては、エンジン自身のコマンド定義とコンポジションルートから取られています。設定がソースで確認できない場合、それは列挙されません。これらのデフォルトの背後にある概念的なセキュリティ姿勢については セキュリティモデル を、実行可能なエンドツーエンドのパスについては セルフホスティング を参照してください。

NATS イベント配信: Core NATS ブリッジと NATS JetStream には Business Identity & Scale が必要です。Community はプロセス内でイベントを配信します。

serve サブコマンド

Section titled “serve サブコマンド”

olivares serve は REST/web HTTP サーバーと gRPC サーバーを 1 つのプロセスで実行し、Web UI は API と同じオリジンから提供されます。以下のフラグは、そのコマンドへの検証済み設定入力です。

フラグ デフォルト 目的
--listen :8443 HTTP リッスンアドレス（REST API + 組み込み Web UI）。
--login-trusted-proxies $OLIVARES_LOGIN_TRUSTED_PROXIES、未設定なら空 パスワードログインの試行回数制限に限って信頼するプロキシの CIDR。フラグに明示的な空の値を指定すると環境変数の値を無効にします。ネットワークポリシー、セッション、監査では引き続きトランスポート接続の相手を使用します。
--grpc-listen :8444 gRPC リッスンアドレス（コントロールプレーン / コレクタインジェスト API）。
--data-dir $OLIVARES_DATA_DIR、既存の ./olivares-data インストール、なければ $XDG_DATA_HOME/olivares または ~/.local/share/olivares データディレクトリ：監査署名鍵、TLS 素材、そして（SQLite の場合）ストアファイル。
--engine sqlite ストアエンジン：sqlite または postgres。
--dsn 空（データディレクトリ内の SQLite ファイル） ストア接続文字列。
--checkpoint-interval 1h すべてのテナントチェーンにわたって署名済み監査チェックポイントを書き込む頻度。0 で無効化。
--insecure オフ HTTP/gRPC を平文で提供します。危険。ローカルホスト開発専用。
--seed-demo オフ デモ/E2E 用に合成サンプル estate をロードします。非 loopback バインドでは起動を拒否します。

TLS はデフォルトでオンです。--tls-cert/--tls-key が供給されない場合、エンジンは、いずれのリスナーが接続を受け入れる前に、データディレクトリに自己署名証明書を一度だけ事前に確実に用意するため、HTTP サーバーと gRPC サーバーは同じ証明書を使い、どちらも平文にフォールバックしません。自己署名証明書を生成するとき、cert_fingerprint_sha256（証明書のダイジェスト。ブラウザーが表示するもの）と pin_sha256（リーフ証明書の SPKI のダイジェスト）をログに記録します。--pin-sha256 は後者を base64 または16進で受け取ります。証明書フィンガープリントは別のダイジェストです。どちらの書き方でも 32 バイトなので解析自体は通り、その後ハンドシェイクで TLS SPKI pin mismatch として失敗し、そのエラーが使うべき値を示します。

完全なフラグの一覧 — 分散デプロイメントで使われる Postgres 専用および相互 TLS のフラグを含む — は CLI リファレンス にあります。このページは共通の設定サーフェスを文書化します。一部の高度なフラグは、アーキテクチャ概要 で説明されるマルチノードトポロジを統治します。

環境変数

Section titled “環境変数”

以下の 3 グループは、オペレーターが最初に遭遇する変数とその動作です。その後に、バイナリより古くならないようエンジン自身のソースから生成された完全な一覧が続きます。

データディレクトリ

Section titled “データディレクトリ”
変数 効果
OLIVARES_DATA_DIR --data-dir が指定されない場合のデフォルトデータディレクトリ。どちらもない場合、エンジンは既存の ./olivares-data インストールを使い、なければ $XDG_DATA_HOME/olivares または ~/.local/share/olivares を使います。カレントワーキングディレクトリは決して使いません — そこに秘密鍵を残してしまうからです。

データディレクトリは、監査署名鍵、TLS 証明書と鍵、そして — SQLite エンジンの場合 — ストアファイルを保持します。再起動をまたいで永続化してください。

実際のソースの配線

Section titled “実際のソースの配線”
変数 効果
OLIVARES_SOURCES_CONFIG エンジン起動前に、実際の観測ソースと ID ロスタープロバイダを配線する JSON ファイルへのパス。

OLIVARES_SOURCES_CONFIG は、非デモのシグナルソースと ID ロスタープロバイダが解決される唯一の入力です。これはオペレータのシークレットを保持する設定であり、意図的にストアの外に置かれます。エンジンは起動中にこれを読み取り、ランタイムの起動 前に すべてのソースを登録します。

起動時は、変数が未設定の場合と、ファイルが指定されている場合を区別します：

  • 欠落した 変数は空の設定を生み、エンジンは実際には何も配線されていないと警告します。
  • 指定されたファイルが存在しない、読み取れない、または有効な JSON でない場合、olivares serve は終了コード 1 で終了します。エラーは load sources operator config: OLIVARES_SOURCES_CONFIG で始まり、refusing to start instead of silently omitting operator configuration を含みます。
  • 設定されたが 空の ソースリストは、いかなるコネクタもインジェストしないと警告するため、estate はライブトラフィックなしで動作します。黙って健全に見えることはありません。
  • 空の ID リストは、ロスターが空のままであり、ロスター同期が no-op であると警告します。

ファイルを指定した場合は、パス、読み取り権限、または JSON を修正して再起動してください。エンジンはオペレーター設定を黙って省略することを拒否します。 アクセスマップをデータで満たすには、少なくとも 1 つのソースを設定してください — ソースを接続する と、OpenTelemetry および MCP 経由の協調的な Claude Code パスについては Claude Code を接続する を参照してください。

認可決定点（PDP）

Section titled “認可決定点（PDP）”

エディション: 外部 PDP は Business の機能です。Community ビルドは、OLIVARES_PDP_ENGINE に cedar、opa、またはその他のエンジン値が設定されていると起動を拒否します。拒否メッセージは Business を示し、終了コード 9 で終了します。未設定、空、または none はどのエディションでも有効です。

認可ポリシー決定点（policy decision point）はコンポジションルートで環境によって選択されます。ネイティブの属性ベースアクセス制御（ABAC）エンジンとロールベースアクセス制御（RBAC）が常に統治します。外部 PDP は、選択された場合、アクセスを決して広げることのできない追加の 制限専用（restrict-only） レイヤーです。

変数 効果
OLIVARES_PDP_ENGINE 外部 PDP を選択します：cedar、opa、または none（空または none はネイティブ ABAC のみを意味します）。
OLIVARES_PDP_CEDAR_FILE Cedar エンジン専用：オペレータの Cedar ポリシーファイルへのパス。
OLIVARES_PDP_OPA_URL OPA エンジン専用：Open Policy Agent エンドポイントのベース URL。
OLIVARES_PDP_OPA_PATH OPA エンジン専用：そのエンドポイント配下で問い合わせる決定パス。
OLIVARES_PDP_OPA_TOKEN OPA エンジン専用：OPA エンドポイント用の Bearer トークン。

1 つの継ぎ目（seam）の背後に 2 つのアダプタが座っています：組み込み Cedar 評価器（プライマリの、純 Go のパス）と、OPA-over-HTTP アダプタです。オペレータは 1 つのエンジンを選びます。どちらも、組み込み RBAC がすでに行った決定を、制限することはできても決して広げることはできません。

deny-by-default モデル、アクセスグラフの閲覧が持つ特権的な性質、そしてすべての認可読み取りがどのように監査されるかについては、セキュリティモデル を参照してください。

OLIVARES_OTEL_PROVIDER_BAGGAGE_ALLOWLIST には、origin、key、values フィールドを持つルールの JSON 配列を設定します。各ルールは、指定した HTTP(S) オリジン、baggage キー、秘密情報を含まない値との完全一致のみを許可します。上限は JSON 16 KiB、32 ルール、各ルール 8 値で、キーと値はそれぞれ 1～64 ASCII バイトです。traceparent と tracestate の継続はこのポリシーとは別であり、宛先の認可も別です。

Complete variable reference

Section titled “Complete variable reference”

The table below is generated from the product’s own sources: 296 variables and 18 runtime-constructed families, covering the engine, the CLI and the connectors. It is regenerated and checked against those sources on every change, so it does not fall behind the binary.

Required means the feature that reads the variable does not start without it; most variables are optional and the engine runs with none of them set.

Variable Required Default What it configures
OLIVARES_ACTOR No — Default --actor for the decision-bearing eventing verbs, so a scripted change still records who made it.
OLIVARES_ADMIN_DSN No — Privileged connection string the Kubernetes operator uses for schema migration, separate from the least-privilege runtime role.
OLIVARES_AGENTCORE_EXPORT_CONFIG No — Path to the JSON configuration of the AgentCore usage export.
OLIVARES_AGENT_GATEWAY_CONFIG No — Path to the JSON configuration of the MCP agent gateway.
OLIVARES_ALLOW_CLEARTEXT No — Dangerous opt-in: lets a request carrying a credential reach a NON-loopback host over plain HTTP, for surfaces with no –allow-cleartext flag of their own.
OLIVARES_APPROVAL_BRIDGE_CONFIG No — Path to the JSON configuration of the bridge that routes approvals to an external system.
OLIVARES_AUDIT_ARCHIVE_CONFIG No — Path to the JSON settings for the Business Regulated Operations s3archive sink. Secret-bearing, so it is a file rather than a value.
OLIVARES_AUDIT_ARCHIVE_DIR No — Root directory for the dir archive sink.
OLIVARES_AUDIT_ARCHIVE_INTERVAL No 24h How often sealed audit segments are archived, as a Go duration.
OLIVARES_AUDIT_ARCHIVE_RETAIN_DAYS No 2555 How long archived audit segments are retained, in days.
OLIVARES_AUDIT_ARCHIVE_SEGMENT_EVENTS No — How many events a sealed archive segment holds before the next one is started.
OLIVARES_AUDIT_ARCHIVE_SINK No — Where sealed audit segments are archived: unset for off, dir for a local directory, s3archive for object storage in Business Regulated Operations.
OLIVARES_AUDIT_LEGALHOLD_INTERVAL No — How often the long-horizon legal-hold sweep runs, as a Go duration.
OLIVARES_AUDIT_LEGALHOLD_RECONCILE No — ファイルパスではなくブール値のスイッチで、有効なリーガルホールドの対象テナントについて、アーカイブ済みの監査セグメントに Object Lock のリーガルホールドを設定する長期リーガルホールド・リコンサイラーを制御します。enterprise と addon_reg のビルドタグ付きでコンパイルされたビルドだけが、エンジンの起動時に読み取ります。変更は再起動後に反映されます。有効化するのは、strconv.ParseBool が true として受け付ける値（true や 1 など）だけです。未設定、false、または解析できない値では、エラーにならず無効のままです。また、Object Lock のリーガルホールドを設定できる sink 上に監査アーカイブが構成されていない限り、無効のままです。
OLIVARES_AUDIT_META_BLINDING No — Whether audit metadata commitments are written blinded, and how strictly that is required.
OLIVARES_AUDIT_SIGNING_KEY No — Audit checkpoint signing key, inline. Prefer the file form so the key never sits in a process environment.
OLIVARES_AUDIT_SIGNING_KEY_FILE No — Path to the audit checkpoint signing key. This is the operator-held form.
OLIVARES_AUDIT_SIGNING_KEY_WRAPPED_FILE No — Path to the audit signing key wrapped by a key management service, unwrapped at boot.
OLIVARES_AUDIT_SPOOL_MAX_BYTES No — Upper bound on the on-disk audit spool before the full-spool rule applies.
OLIVARES_AUDIT_SPOOL_ON_FULL No — What happens when the audit spool is full: the deny-closed posture refuses the write rather than dropping the record.
OLIVARES_AUTHZEN_ALLOWED_CIDRS No — Comma-separated CIDR ranges allowed to reach the AuthZEN endpoints. Unset leaves the endpoint reachable wherever the listener is.
OLIVARES_AUTHZEN_DISABLED No — Set to a true value to turn the AuthZEN decision endpoint off.
OLIVARES_AUTHZEN_EXPORT_DISABLED No — Set to a true value to turn the AuthZEN export endpoint off.
OLIVARES_AUTHZEN_SEARCH_DISABLED No — Set to a true value to turn the AuthZEN search endpoints off while leaving decisions on.
OLIVARES_BASE_URL No — Public base URL of this engine, used where an absolute link back to it has to be produced.
OLIVARES_BUS_CONFIG No — Path to the JSON configuration of the message bus the engine publishes on.
OLIVARES_CAEP_TRANSMITTER_CONFIG No — Path to the JSON configuration of the CAEP transmitter that pushes shared-signal events.
OLIVARES_CATALOG_SIGNING_KEY No — Catalog signing key, inline. Prefer the file form.
OLIVARES_CATALOG_SIGNING_KEY_FILE No — Path to the catalog signing key.
OLIVARES_CATALOG_SIGNING_KEY_WRAPPED_FILE No — Path to the catalog signing key wrapped by a key management service.
OLIVARES_CIRCUIT_BREAKER_CONFIG No — _CONFIG という接尾辞が付いていますがファイルパスではなく、ランタイムのサーキットブレーカーを制御するブール値のスイッチです。テナントごとのルールはここでは設定しません。enterprise と addon_airs のビルドタグ付きでコンパイルされたビルドだけが、エンジンの起動時に読み取ります。変更は再起動後に反映されます。未設定、または strconv.ParseBool が false として受け付ける値では、ブレーカーは無効のままです。ブール値ではない値はエラーとしてログに記録され、この場合も無効のままです。true の値は、モジュールデータが利用可能な場合に有効化します。利用できない場合は警告をログに記録し、無効のままです。
OLIVARES_CLAUDE_ADMIN_ACTUATOR_CONFIG No — Path to the JSON configuration of the administrative actuator that applies changes at the model provider.
OLIVARES_CLAUDE_ADMIN_KEY No — Administrative API key used to read identity posture from the model provider.
OLIVARES_CLAUDE_ERASER_CONFIG No — Path to the JSON configuration of the erasure actuator that carries out deletion requests.
OLIVARES_CLAUDE_FILES_CONFIG No — Path to the JSON configuration of the provider file inventory scan.
OLIVARES_CLAUDE_INFERENCE_KEY No — API key the engine uses for its own inference calls. Unset leaves the inference-backed features off.
OLIVARES_CLAUDE_WORKSPACE_ID No — Workspace whose identity posture is read, when the administrative key spans several.
OLIVARES_CLI_CONFIG No — Path to the CLI configuration file, replacing the default per-user location. Used by hermetic automation.
OLIVARES_CLI_TRAMPOLINE No — Set to 1 inside a re-executed child process so the binary runs the requested subcommand instead of the outer test harness.
OLIVARES_CODEX_HOOK_ACCOUNT No — Account the Codex hook client reports.
OLIVARES_CODEX_HOOK_AGENT No — Agent identity the Codex hook client reports.
OLIVARES_CODEX_HOOK_ORG No — Organization the Codex hook client reports.
OLIVARES_CODEX_HOOK_PEP_CONFIG No — Path to the JSON configuration of the Codex hook enforcement point server.
OLIVARES_CODEX_HOOK_TENANT No — Tenant the Codex hook client reports.
OLIVARES_CODEX_HOOK_TOKEN No — Token the Codex hook client presents to the enforcement point.
OLIVARES_CODEX_HOOK_URL No — Base URL of the enforcement point the Codex hook client calls.
OLIVARES_COMMUNICATION_ACTIVATION No — REQUESTED K3 communication activation (on or off; default off), parsed at boot by cmd/olivares/communicationcomposition.go. on binds the local outbox pump witness and enables the dual runtime credential posture before the first leadership election; whether a communication credential can actually be minted is decided per launch from the EFFECTIVE readiness conjunction (store proof, sealer, directory resolver, permissions, pump), never from this flag alone. on needs both keyring files below; when either is not declared, cannot be opened or does not load, boot continues with K3 OFF and the cause visible (composition log, pump lane verdict custody_unavailable, non-effective readiness) while core, K1 and K2 serve. Only an unrecognized value is a configuration error.
OLIVARES_COMMUNICATION_CONTENT_KEYRING_FILE Yes — Path to the JSON keyring the communication content sealer loads at boot (cmd/olivares/boot.go). Secret-bearing, so it is a file rather than a value: sealed message bodies are verified against the keys it carries, and an engine started without it cannot open content sealed by a peer that had one.
OLIVARES_COMMUNICATION_CURSOR_KEYRING_FILE Yes — Path to the JSON keyring (olivares.communication-cursor-keyring.v1) that signs and verifies inbox cursor navigation tokens, loaded at boot through the same custody mechanism as the content keyring (cmd/olivares/communicationcursorkeyring.go). Secret-bearing, so it is a file rather than a value; a rotated-out key marked retired_at keeps verifying for the token retention window and is dropped afterwards, and a restart never mints a fresh key.
OLIVARES_COMMUNICATION_TOKEN Yes — セッション自身の通信認証情報。セッションランチャーが注入し、メッセージコマンドが読み取ります。起動経路で予約されているため、運用担当者が指定してはいけません。値は常にマスクされます。
OLIVARES_COMPUTER_USE_CONFIG No — computer-use ゲートの JSON ポリシーファイルへのパス。enterprise と addon_airs のビルドタグ付きでコンパイルされたビルドだけが読み取ります。未設定の場合、ゲートは無効のままです。ファイルを読み取れない場合や解析できない場合は、ファイルを修正してエンジンを再起動するまで、すべての computer use を拒否します。
OLIVARES_CONFIG_STRICT No — Set to 1 to make olivares config effective and config validate reject any unrecognized OLIVARES_* key.
OLIVARES_CONTENT_FIREWALL_CONFIG No — インラインプロキシ内の推論トラフィックを検査するコンテンツファイアウォールの JSON ポリシーファイルへのパス。enterprise と addon_airs のビルドタグ付きでコンパイルされたビルドだけが読み取ります。未設定の場合、その検査は無効のままです。ファイルを読み取れない場合や解析できない場合は、ファイルを修正してエンジンを再起動するまで、ファイアウォールが検査するすべてのリクエストを拒否します。
OLIVARES_CONTEXT_MAX_TOKENS No — Upper bound on the context a governed session may assemble, in tokens.
OLIVARES_CONTEXT_STRATEGY No — Which strategy assembles a governed session’s context when the bound is reached.
OLIVARES_CREDENTIAL_MINTER_CONFIG No — MCP ゲートウェイの、サーバーごとのアップストリーム認証情報ミンター（RFC 8693 のトークン交換）の JSON 設定へのパス。シークレットを含むため、値ではなくファイルで指定します。enterprise のビルドタグ付きでコンパイルされたビルドが、エンジンが起動し、アップストリーム URL 向けのゲートウェイを構築するときに読み取ります。未設定の場合は静的なアップストリーム認証情報を維持します。ファイルを読み取れない場合や解析できない場合は、ファイルを修正してエンジンを再起動するまで、すべてのアップストリーム認証情報を拒否します。
OLIVARES_DATA_DIR No — Data directory used when --data-dir is not given: audit signing key, TLS material and, for SQLite, the store file.
OLIVARES_DB_MAX_CONNS No — Upper bound on pooled database connections. Unset leaves the driver default.
OLIVARES_DEPLOY_EXECUTOR_CONFIG No — Path to the JSON configuration of the executor that applies deployment changes.
OLIVARES_DR_KEK_FILE No — Path to a raw 32-byte key-encryption key for backups, for the path where a key management service does the unwrapping.
OLIVARES_DR_OFFSITE_ACCESS_KEY_ID_FILE No — Path to the file holding the offsite access key id, so the credential stays out of the environment.
OLIVARES_DR_OFFSITE_BUCKET No — Offsite bucket for disaster-recovery bundles. Setting it turns offsite replication on.
OLIVARES_DR_OFFSITE_ENDPOINT No — S3-compatible endpoint for offsite replication. Unset means AWS S3 in the configured region.
OLIVARES_DR_OFFSITE_PREFIX No — Key prefix for bundles inside the offsite bucket.
OLIVARES_DR_OFFSITE_REGION No — Region for offsite replication.
OLIVARES_DR_OFFSITE_SECRET_ACCESS_KEY_FILE No — Path to the file holding the offsite secret access key.
OLIVARES_DR_OFFSITE_SESSION_TOKEN_FILE No — Path to the file holding an offsite session token, for temporary credentials.
OLIVARES_DR_PASSPHRASE_FILE No — Path to the backup passphrase file, from which the backup key-encryption key is derived.
OLIVARES_DR_SCHEDULE_INTERVAL No — How often the scheduled backup runs, as a Go duration.
OLIVARES_DSN No — Store connection string injected by the Kubernetes operator into the engine it manages.
OLIVARES_DURABLE_BUS_CONFIG No — Path to the JSON configuration of the durable bus, for at-least-once delivery across replicas.
OLIVARES_ELICITATION_MEDIATOR_CONFIG No — MCP エリシテーション（elicitation）メディエーターの JSON ポリシーファイルへのパス。enterprise と addon_airs のビルドタグ付きでコンパイルされたビルドだけが読み取ります。未設定の場合、メディエーションは無効のままです。ファイルを読み取れない場合や解析できない場合は、ファイルを修正してエンジンを再起動するまで、メディエーターがすべてのエリシテーションを拒否します。
OLIVARES_EMBEDDINGS_BASE_URL No — Endpoint the openai-compatible embeddings provider is called at.
OLIVARES_EMBEDDINGS_DIM No — Vector dimension the openai-compatible provider returns, which has to match the index.
OLIVARES_EMBEDDINGS_GEO No — Region or data-residency hint sent to the openai-compatible provider.
OLIVARES_EMBEDDINGS_KEY No — Api key for the openai-compatible embeddings provider.
OLIVARES_EMBEDDINGS_MODEL No — Embedding model requested from the openai-compatible provider.
OLIVARES_EMBEDDINGS_OPENAI_BASE_URL No — Endpoint the openai embeddings provider is called at.
OLIVARES_EMBEDDINGS_OPENAI_COMPAT_BASE_URL No — Endpoint the openai-compatible embeddings provider is called at.
OLIVARES_EMBEDDINGS_OPENAI_COMPAT_DIM No — Vector dimension the openai-compatible provider returns, which has to match the index.
OLIVARES_EMBEDDINGS_OPENAI_COMPAT_GEO No — Region or data-residency hint sent to the openai-compatible provider.
OLIVARES_EMBEDDINGS_OPENAI_COMPAT_KEY No — Api key for the openai-compatible embeddings provider.
OLIVARES_EMBEDDINGS_OPENAI_COMPAT_MODEL No — Embedding model requested from the openai-compatible provider.
OLIVARES_EMBEDDINGS_OPENAI_DIM No — Vector dimension the openai provider returns, which has to match the index.
OLIVARES_EMBEDDINGS_OPENAI_GEO No — Region or data-residency hint sent to the openai provider.
OLIVARES_EMBEDDINGS_OPENAI_KEY No — Api key for the openai embeddings provider.
OLIVARES_EMBEDDINGS_OPENAI_MODEL No — Embedding model requested from the openai provider.
OLIVARES_EMBEDDINGS_PROVIDER No — Which embeddings provider is used, pinning one instead of taking the first that is configured.
OLIVARES_EMBEDDINGS_REQUIRE No — Set to a true value to make a missing or unusable embeddings provider a refusal rather than a degraded index.
OLIVARES_EMBEDDINGS_SELF_HOSTED_BASE_URL No — Endpoint the self-hosted embeddings provider is called at.
OLIVARES_EMBEDDINGS_SELF_HOSTED_DIM No — Vector dimension the self-hosted provider returns, which has to match the index.
OLIVARES_EMBEDDINGS_SELF_HOSTED_GEO No — Region or data-residency hint sent to the self-hosted provider.
OLIVARES_EMBEDDINGS_SELF_HOSTED_KEY No — Api key for the self-hosted embeddings provider.
OLIVARES_EMBEDDINGS_SELF_HOSTED_MODEL No — Embedding model requested from the self-hosted provider.
OLIVARES_EMBEDDINGS_VOYAGE_BASE_URL No — Endpoint the voyage embeddings provider is called at.
OLIVARES_EMBEDDINGS_VOYAGE_DIM No — Vector dimension the voyage provider returns, which has to match the index.
OLIVARES_EMBEDDINGS_VOYAGE_GEO No — Region or data-residency hint sent to the voyage provider.
OLIVARES_EMBEDDINGS_VOYAGE_KEY No — Api key for the voyage embeddings provider.
OLIVARES_EMBEDDINGS_VOYAGE_MODEL No — Embedding model requested from the voyage provider.
OLIVARES_EVALS_MONITOR_WINDOW No — Time window the evaluation monitor scores, as a Go duration.
OLIVARES_EVENTING_ALLOW_LOOPBACK No — Set to a true value to allow loopback destinations. Single-box development only, because the default refusal is what blocks server-side request forgery.
OLIVARES_EVENTING_DISPATCH_INTERVAL No 15s How often queued events are dispatched, as a Go duration. 0 disables the pump.
OLIVARES_EVENTING_EGRESS_POLICY No — Path to the JSON policy that decides which destinations outbound events may reach. A policy that does not parse leaves eventing unwired rather than open.
OLIVARES_EVENTING_RETENTION No 168h How long delivered events are kept for replay, as a Go duration.
OLIVARES_EVENTING_SECRET_KEY No — Key that encrypts eventing subscription signing secrets at rest.
OLIVARES_EXECUTION_ENVIRONMENT_ID No — Explicit execution-environment reference for this node, read at boot by cmd/olivares/providerprofiles.go. Unset, the engine generates one identity once into execution-environment-id in the data directory (0600, atomic exclusive create) and reuses it; set, the value must be 1..256 printable bytes with no whitespace, colon or vertical bar, and a malformed value refuses boot instead of degrading in silence. It is REQUIRED on a topology with only shared state and no node-local data directory: there, without it, profiled session launches stay deny-closed.
OLIVARES_EXTRA_ARGS No — Extra serve arguments appended by the packaged service unit, for operators who configure the daemon through an environment file.
OLIVARES_FINOPS_ADMISSION_LEGACY_WRITERS_STOPPED_AT No — Instant every writer of the earlier FinOps admission build stopped, as an RFC 3339 time in UTC ending in Z. Read once at startup. Recovery retires a claim those writers left, but only once five minutes have passed since this instant and only while no row they left is dated later; empty, the default, or text that is not such an instant retires none.
OLIVARES_GITPUBLISH_SWEEP_INTERVAL No 1m Git 公開のスイープが古くなったディスパッチを解決し、不確定な公開を再観測する間隔。Go の duration で指定します。0 で無効化します。
OLIVARES_GROK_HOOK_ACCOUNT No — Account the Grok Build hook client reports.
OLIVARES_GROK_HOOK_AGENT No — Agent identity the Grok Build hook client reports.
OLIVARES_GROK_HOOK_ORG No — Organization the Grok Build hook client reports.
OLIVARES_GROK_HOOK_PEP_CONFIG No — Path to the JSON configuration of the Grok Build hook enforcement point server. Absent mounts nothing; a path given must be readable and valid or startup fails closed.
OLIVARES_GROK_HOOK_TENANT No — Tenant the Grok Build hook client acts in.
OLIVARES_GROK_HOOK_TOKEN No — Bearer credential the Grok Build hook client presents to the enforcement point.
OLIVARES_GROK_HOOK_URL No — Endpoint of the enforcement point the Grok Build hook client calls; unset denies, deny-closed.
OLIVARES_GUARDIAN_SWEEP_INTERVAL No — How often the guardian sweep runs, as a Go duration. 0 disables it.
OLIVARES_HA_LEADER_GATE No — Set to 1 to make background loops run only on the elected leader, so a multi-replica deployment does not run them twice. Business edition only: a Community binary with this set refuses to start and names Business.
OLIVARES_HA_LEADER_LABEL No — Label this replica publishes when it holds leadership, so an operator can route to the leader. Business edition only: a Community binary with this set refuses to start and names Business.
OLIVARES_HITL_CONFIG No — Path to the JSON configuration of the human-in-the-loop review path.
OLIVARES_HOOK_FIREWALL_CONFIG No — Path to the JSON configuration of the data-loss firewall that runs inside the hook. Unset leaves that half off.
OLIVARES_HOOK_PEP_ACCOUNT No — Account the Claude Code hook client reports.
OLIVARES_HOOK_PEP_AGENT No — Agent identity the Claude Code hook client reports.
OLIVARES_HOOK_PEP_CONFIG No — Path to the JSON configuration of the hook enforcement point server.
OLIVARES_HOOK_PEP_ORG No — Organization the Claude Code hook client reports.
OLIVARES_HOOK_PEP_TENANT No — Tenant the Claude Code hook client reports.
OLIVARES_HOOK_PEP_TOKEN No — Token the Claude Code hook client presents to the enforcement point.
OLIVARES_HOOK_PEP_URL No — Base URL of the enforcement point the Claude Code hook client calls.
OLIVARES_INCIDENTLOOP_CONFIG No — Path to the JSON configuration of the incident close-the-loop subscriber. Read by the Business edition.
OLIVARES_INFERENCE_PROXY_CONFIG No — Path to the JSON configuration of the governed inference proxy.
OLIVARES_INGEST_TOKEN No — Bearer token the collector ingest endpoint requires from telemetry senders.
OLIVARES_INSECURE No — Set to 1 to let the CLI talk to a plaintext or untrusted-TLS endpoint. Local development only.
OLIVARES_INVITE_MAIL_DESTINATION No — Name of the email destination in the notification file, scoped to no tenant, that invitations are mailed through. Without it, and without a declared console address, invite mode is unavailable.
OLIVARES_KEY_CUSTODY No — Business edition only. Custody posture required of the audit signing key: whether a raw on-disk key is accepted or a wrapped one is demanded. Community refuses to run with byok or cmek; unset is valid in every edition.
OLIVARES_KEY_WRAP_AWS_KEY_ID No — Key identifier in AWS KMS. Used by the backend that wraps the signing keys.
OLIVARES_KEY_WRAP_AWS_REGION No — Region of the AWS KMS key. Used by the backend that wraps the signing keys.
OLIVARES_KEY_WRAP_AZURE_KEY_NAME No — Key name in Azure Key Vault. Used by the backend that wraps the signing keys.
OLIVARES_KEY_WRAP_AZURE_KEY_VERSION No — Key version in Azure Key Vault. Unset uses the current version. Used by the backend that wraps the signing keys.
OLIVARES_KEY_WRAP_AZURE_TOKEN No — Token used against Azure Key Vault. Used by the backend that wraps the signing keys.
OLIVARES_KEY_WRAP_AZURE_VAULT_URL No — Azure Key Vault URL. Used by the backend that wraps the signing keys.
OLIVARES_KEY_WRAP_GCP_KEY No — Fully qualified key version name in Google Cloud KMS. Used by the backend that wraps the signing keys.
OLIVARES_KEY_WRAP_GCP_TOKEN No — Token used against Google Cloud KMS. Used by the backend that wraps the signing keys.
OLIVARES_KEY_WRAP_GCP_TOKEN_FILE No — Path to the file holding the token used against Google Cloud KMS. Used by the backend that wraps the signing keys.
OLIVARES_KEY_WRAP_OLD No — Previous key management backend during a rewrap migration, so keys wrapped by it can still be unwrapped.
OLIVARES_LEDGER_CUSTODY No — Business edition only. Custody posture required of the ledger checkpoint signer, the ledger counterpart of the audit key posture. Community refuses to run with hyok; unset is valid in every edition.
OLIVARES_LEDGER_KMS_AWS_KEY_ID No — Business edition only. Key identifier in AWS KMS. Used by the backend that signs audit checkpoints.
OLIVARES_LEDGER_KMS_AWS_REGION No — Business edition only. Region of the AWS KMS key. Used by the backend that signs audit checkpoints.
OLIVARES_LEDGER_KMS_AWS_SIGNING_ALG No — Business edition only. Signing algorithm requested from AWS KMS. Used by the backend that signs audit checkpoints.
OLIVARES_LEDGER_KMS_AZURE_KEY_NAME No — Business edition only. Key name in Azure Key Vault. Used by the backend that signs audit checkpoints.
OLIVARES_LEDGER_KMS_AZURE_KEY_VERSION No — Business edition only. Key version in Azure Key Vault. Unset uses the current version. Used by the backend that signs audit checkpoints.
OLIVARES_LEDGER_KMS_AZURE_TOKEN No — Business edition only. Token used against Azure Key Vault. Used by the backend that signs audit checkpoints.
OLIVARES_LEDGER_KMS_AZURE_VAULT_URL No — Business edition only. Azure Key Vault URL. Used by the backend that signs audit checkpoints.
OLIVARES_LEDGER_KMS_GCP_KEY No — Business edition only. Fully qualified key version name in Google Cloud KMS. Used by the backend that signs audit checkpoints.
OLIVARES_LEDGER_KMS_GCP_TOKEN No — Business edition only. Token used against Google Cloud KMS. Used by the backend that signs audit checkpoints.
OLIVARES_LEDGER_KMS_GCP_TOKEN_FILE No — Business edition only. Path to the file holding the token used against Google Cloud KMS. Used by the backend that signs audit checkpoints.
OLIVARES_LEDGER_SIGNER No — Business edition only. Off-box checkpoint signer to use: which key management backend signs audit checkpoints instead of a local key. Community refuses to run with any value except unset, on-box or ed25519.
OLIVARES_LICENSE No — License document itself, inline, for deployments that cannot mount a file.
OLIVARES_LICENSE_PATH No — Path to the license document on disk. Takes effect before the inline form.
OLIVARES_LICENSE_PUBKEY No — Public key the engine verifies the license signature against.
OLIVARES_LIVEINGEST_INSPECT_OBSERVED_REFS No — Set to 1 to make live ingest inspect observed references, which costs more per event.
OLIVARES_LOGIN_ENFORCEMENT No — ログイン強制（require-SSO とログイン用 IP 許可リスト）のブレークグラス・スイッチであり、ファイルパスではありません。エンジン起動時にすべてのビルドが読み取り、変更は再起動後に反映されます。off、0、false、no、disabled は、大文字小文字を問わず、前後の空白も無視して運用者のブレークグラスを選択します。未設定またはその他の値の場合、強制はコンソールから保存されたポスチャに従います。強制コンポーネントをリンクしたビルドは、保存内容にかかわらずそのポスチャの適用を停止し、警告を記録します。リンクしていないビルドも同じ意図的な選択を記録します。すなわち、この配備に強制の履歴と設定済みのポスチャがある場合に本来行う起動拒否を省略し、ノードの昇格時に永続的な運用者リカバリ・イベントを追記します。
OLIVARES_LOGIN_TRUSTED_PROXIES No — パスワードログインの試行回数制限に使用するアドレスに限り、X-Forwarded-For による指定を信頼する IPv4/IPv6 プロキシの CIDR をカンマで区切った一覧。空の場合はどのプロキシも信頼しません。–login-trusted-proxies フラグが優先され、明示的な空の値も優先されます。無効な CIDR または空のリスト要素があると起動を拒否します。起動時に一度だけ読み込まれ、ポリシー、セッション、監査では引き続きトランスポート接続の相手を使用します。リクエストの上限である 8192 バイトと 64 エントリについては docs/SECURITY-HARDENING.md を参照してください。
OLIVARES_LOG_LEVEL No — Minimum log level the engine emits: debug, info, warn or error.
OLIVARES_MCP_TASK_KILLSWITCH_SWEEP No — How often a running MCP task is re-checked against the kill switch, as a Go duration.
OLIVARES_METRICS_ALLOWED_CIDRS No — Comma-separated CIDR ranges allowed to scrape the metrics endpoint.
OLIVARES_METRICS_TOKEN No — Bearer token the metrics endpoint requires. Unset leaves the endpoint unauthenticated behind whatever the listener exposes.
OLIVARES_MODEL_GATEWAY_CHAT_MODE いいえ disabled 同期型のガバナンス対象 Chat ディスパッチを有効化するモード。未設定または disabled では無効のままです。development_precheck は既存の非アトミックで fail-open なルーティング事前検査を明示的に有効化するだけで、厳格な金額予算ではありません。それ以外の値は起動エラーになります。
OLIVARES_MODEL_GATEWAY_PROFILES_CONFIG いいえ — モデルゲートウェイの不変な実行プロファイルを格納するローカル JSON ファイルへのパス。未設定の場合はプロファイルを読み込まず、ファイルを読み取れない場合や無効な場合は起動を停止します。
OLIVARES_NHI_ACTUATORS_CONFIG No — Path to the JSON configuration of the actuators that act on non-human identities.
OLIVARES_NIS2INCIDENT_CONFIG No — Path to the JSON configuration of NIS2 incident reporting. Read by the Business edition.
OLIVARES_NOTIFY_CONFIG No — Path to the JSON list of notification destinations. Secret-bearing, so it stays out of the store.
OLIVARES_NOTIFY_DISPATCH_INTERVAL No — How often queued notifications are dispatched, as a Go duration. 0 disables the pump.
OLIVARES_OIDC_CLIENT_ID Yes — OIDC client id for this engine. Required when the protocol is oidc.
OLIVARES_OIDC_CLIENT_SECRET Yes — OIDC client secret for this engine. Required when the protocol is oidc.
OLIVARES_OIDC_GROUPS_CLAIM No — ID-token or UserInfo claim carrying group membership. Unset leaves group mapping off.
OLIVARES_OIDC_ISSUER Yes — OIDC issuer URL. Required when the protocol is oidc.
OLIVARES_ONBOARDING_CONFIG No — オンボーディング準備状況アセッサーの JSON 設定へのパス。enterprise のビルドタグ付きでコンパイルされたビルドが、olivares enterprise readiness を実行するたびに読み取ります。エンジンの起動時には読み取りません。{} は標準プロファイルを選択します。未設定の場合、またはファイルを読み取れない場合や解析できない場合、このコマンドはオンボーディング準備状況が構成されていないと報告します。
OLIVARES_ORCH_CADENCE_INTERVAL No — How often the orchestration cadence loop runs, as a Go duration. 0 disables it.
OLIVARES_ORCH_DISPATCH_CONFIG No — Path to the JSON configuration for orchestration dispatch targets.
OLIVARES_ORCH_WORKFLOW_INTERVAL No 15s How often the orchestration workflow loop advances waiting runs, as a Go duration.
OLIVARES_ORCH_WORKFLOW_MAX No — Upper bound on concurrently advancing workflow runs.
OLIVARES_ORCH_WORKFLOW_STEPS_MAX No — Upper bound on the steps one workflow run may take, which stops a loop from running forever.
OLIVARES_OTA_PUBKEY No — Public key the engine verifies a downloaded update bundle against.
OLIVARES_OTEL_ENABLED No — Set to a true value to export traces. Setting an endpoint turns export on as well.
OLIVARES_OTEL_ENDPOINT No — OTLP endpoint traces are exported to. Falls back to the standard OTEL_EXPORTER_OTLP_ENDPOINT.
OLIVARES_OTEL_GENAI_COMPAT No — Set to a true value to also emit the generative-AI semantic-convention attributes on spans.
OLIVARES_OTEL_INSECURE No — Set to a true value to export traces over plaintext. Local development only.
OLIVARES_OTEL_PROTOCOL No — OTLP protocol used for export. Falls back to the standard OTEL_EXPORTER_OTLP_PROTOCOL.
OLIVARES_OTEL_PROVIDER_BAGGAGE_ALLOWLIST No [] JSON array of exact HTTP(S) origin, baggage key and non-secret control values allowed through the mounted AnthropicHTTPClient; empty denies baggage. Invalid policy reports a bounded reason once at construction and suppresses baggage without blocking inference.
OLIVARES_OTEL_SAMPLE_RATIO No — Fraction of traces sampled, between 0 and 1.
OLIVARES_OTEL_SERVICE_NAME No — Service name reported on exported traces.
OLIVARES_PDF_RENDER_TIMEOUT No 30s Chromium による PDF レポートの 1 回のレンダリングに許可する最大時間。単位付きの正の Go duration で指定します。レポート用アドオンがレンダリングごとに読み込み、正の duration でない値は Chromium の起動前に変数名を示して拒否されます。低速なホストで構造的なレンダリングがデフォルトの制限時間内に終わらない場合は、この値を増やしてください。
OLIVARES_PDP_CEDAR_FILE No — Business edition only. Path to the Cedar policy file, for the cedar decision point.
OLIVARES_PDP_ENGINE No — Business edition only. External policy decision point to add on top of the native engine: cedar, opa or none. Community refuses serving with cedar, opa or any other engine value; unset, blank or none is valid there.
OLIVARES_PDP_OPA_PATH No — Business edition only. Decision path queried under the Open Policy Agent endpoint.
OLIVARES_PDP_OPA_TOKEN No — Business edition only. Bearer token for the Open Policy Agent endpoint.
OLIVARES_PDP_OPA_URL No — Business edition only. Base URL of the Open Policy Agent endpoint, for the opa decision point.
OLIVARES_PIV_CONFIG No — Path to the JSON configuration for Business Identity & Scale smart-card privileged login. Community refuses serving with this setting; data backup remains available.
OLIVARES_PLUGIN No — Handshake cookie an out-of-process connector plugin must present. Set by the engine when it launches the plugin, not by the operator.
OLIVARES_POLICY_MAX_STALENESS No — How stale a cached policy decision may be before it is refused, as a Go duration.
OLIVARES_POLICY_SIGNING_KEY No — Policy bundle signing key, inline. Prefer the file form.
OLIVARES_POLICY_SIGNING_KEY_FILE No — Path to the policy bundle signing key.
OLIVARES_POLICY_SIGNING_KEY_WRAPPED_FILE No — Path to the policy signing key wrapped by a key management service.
OLIVARES_PQC_POSTURE_CONFIG No — ポスト量子ポスチャアセッサーの JSON 設定へのパス。enterprise のビルドタグ付きでコンパイルされたビルドが、olivares enterprise pqc-posture を実行するたびに読み取ります。エンジンの起動時には読み取りません。{} は CNSA 2.0 と目標年 2033 を選択します。未設定の場合、またはファイルを読み取れない場合や解析できない場合、このコマンドは PQC ポスチャが構成されていないと報告します。
OLIVARES_PUBLIC_URL No — The address a browser reaches this console at, as scheme://host[:port]. It is what the startup panel prints and what the WebAuthn relying party is derived from, and it is independent of the listen address. The –public-url flag wins over this variable, and passing that flag empty clears it. Read at start-up only: a change takes a restart. Refused values are reported by field and failure class and are never echoed, and support bundles keep this value redacted.
OLIVARES_RATELIMIT_CONFIG No — Path to the JSON rate-limit policy the engine applies to its own endpoints.
OLIVARES_RATELIMIT_STORE No — Where rate-limit counters live, which decides whether limits are per replica or shared.
OLIVARES_RENDER_INSPECTOR_CONFIG No — レンダリングされた MCP App コンテンツを検査するインスペクターの JSON ポリシーファイルへのパス。enterprise と addon_airs のビルドタグ付きでコンパイルされたビルドだけが読み取ります。未設定の場合、その検査は無効のままです。ファイルを読み取れない場合や解析できない場合は、ファイルを修正してエンジンを再起動するまで、インスペクターがレンダリングされたすべてのコンテンツを拒否します。
OLIVARES_REPORTING_CONFIG No — Path to the JSON configuration of the reporting add-on. Read by the Business edition.
OLIVARES_REPORTING_SCHEDULE_INTERVAL No — How often scheduled reports are generated, as a Go duration.
OLIVARES_REPORT_CACHE_DIR No — Directory where generated report artifacts are cached.
OLIVARES_RETENTION_GOVERNOR_CONFIG No — 規制上の保持期間下限ガバナーの JSON 設定へのパス。enterprise と addon_reg のビルドタグ付きでコンパイルされたビルドだけが、エンジンの起動時に読み取ります。未設定の場合、保持期間の下限は強制しません。ファイルを読み取れない場合や解析できない場合は、ファイルを修正してエンジンを再起動するまで、すべての保持クラスの下限を 100 年にします。
OLIVARES_RETENTION_SWEEP_INTERVAL No — How often the retention sweep deletes data past its retention window, as a Go duration.
OLIVARES_RTBF_DEPTH_CONFIG No — RTBF のクリプトシュレッド・コーディネーターの JSON 設定へのパス。enterprise と addon_reg のビルドタグ付きでコンパイルされたビルドだけが、エンジンの起動時に読み取ります。未設定の場合、オープンコアのクリプトシュレッディングは変わりません。ファイルを読み取れない場合や解析できない場合は、ファイルを修正してエンジンを再起動するまで、すべてのシュレッドをブロックします。
OLIVARES_SAML_ACS_URL Yes — Assertion consumer service URL of this service provider, where the identity provider posts the assertion.
OLIVARES_SAML_EMAIL_ATTRIBUTE No — Assertion attribute carrying the user’s email. Unset tries the common attribute names.
OLIVARES_SAML_GROUPS_ATTRIBUTE No — Multi-valued assertion attribute carrying group membership. Unset leaves group mapping off.
OLIVARES_SAML_IDP_METADATA_URL No — Identity-provider metadata URL, from which the SAML endpoints and certificate are read.
OLIVARES_SAML_IDP_SSO_URL No — Identity-provider single sign-on URL, for the path where metadata is not fetched.
OLIVARES_SAML_SP_CERT_PEM No — Service-provider encryption certificate in PEM, published as the encryption key descriptor.
OLIVARES_SAML_SP_ENTITY_ID Yes — Entity id this engine presents as the SAML service provider. Required when the protocol is saml.
OLIVARES_SAML_SP_KEY_PEM No — Service-provider encryption private key in PEM, which decrypts encrypted assertions.
OLIVARES_SAML_SP_SIGN_CERT_PEM No — Service-provider signing certificate in PEM, published as the signing key descriptor.
OLIVARES_SAML_SP_SIGN_KEY_PEM No — Service-provider signing private key in PEM, which signs authentication requests.
OLIVARES_SANDBOX_RUNTIME_CONFIG No — Path to the JSON configuration of the sandbox runtime that isolates agent execution.
OLIVARES_SECRETREF_AWS_REGION No — Region used for AWS Secrets Manager references. Falls back to AWS_REGION and AWS_DEFAULT_REGION.
OLIVARES_SECRETREF_AZURE_API_VERSION No — Azure Key Vault API version requested.
OLIVARES_SECRETREF_AZURE_TOKEN No — Token used against Azure Key Vault.
OLIVARES_SECRETREF_AZURE_VAULT_URL No — Default Azure Key Vault URL for references that do not name one.
OLIVARES_SECRETREF_GCP_ENDPOINT No — Endpoint override for Google Secret Manager.
OLIVARES_SECRETREF_GCP_PROJECT No — Default Google Cloud project for Secret Manager references that do not name one.
OLIVARES_SECRETREF_GCP_TOKEN No — Token used against Google Secret Manager.
OLIVARES_SECRETREF_INFISICAL_ENV No — Default Infisical environment for references that do not name one.
OLIVARES_SECRETREF_INFISICAL_TOKEN No — Token used against Infisical.
OLIVARES_SECRETREF_INFISICAL_URL No — Base URL of the Infisical server secret references resolve against.
OLIVARES_SECRETREF_INFISICAL_WORKSPACE_ID No — Default Infisical workspace for references that do not name one.
OLIVARES_SECRETREF_K8S_APISERVER No — Kubernetes API server secret references resolve against.
OLIVARES_SECRETREF_K8S_CA_FILE No — Path to the certificate authority bundle used to verify the Kubernetes API.
OLIVARES_SECRETREF_K8S_TOKEN_FILE No — Path to the service-account token file used against the Kubernetes API.
OLIVARES_SECRETREF_VAULT_ADDR No — Address of the HashiCorp Vault server secret references resolve against. Falls back to VAULT_ADDR.
OLIVARES_SECRETREF_VAULT_NAMESPACE No — Vault namespace secret references resolve in. Falls back to VAULT_NAMESPACE.
OLIVARES_SECRETREF_VAULT_TOKEN No — Token used against HashiCorp Vault.
OLIVARES_SECRET_STORE_KEY No — Key that encrypts operator secrets held in the store.
OLIVARES_SERVERTOOL_EGRESS_CONFIG No — インラインプロキシ内のプロバイダーのサーバーツール（Web 検索、Web フェッチ、コード実行）に対する egress ゲートの JSON 許可（grants）ファイルへのパス。enterprise と addon_airs のビルドタグ付きでコンパイルされたビルドだけが読み取ります。未設定の場合、それらのツールは観測のみのままです。ファイルを読み取れない場合や解析できない場合は、ファイルを修正してエンジンを再起動するまで、認識されたすべての egress サーバーツールを拒否します。
OLIVARES_SERVER_URL No — Base URL of the engine the CLI talks to, when --server is not given.
OLIVARES_SESSIONS_AGENT_LINK_LISTEN No — エージェントリンクの待ち受けアドレス。host:port 形式で、このソースツリーを基にしたエディションがノードエージェントに提供する相互 TLS エンドポイントです。起動時に読み込まれ、デフォルトの空の値ではリスナーを開きません。Community ビルドはこの変数を読み込みません。
OLIVARES_SESSIONS_MANAGED_STOP_ADMISSION_TIMEOUT No 10s 管理対象の Stop リクエストを受け付けるまでの最大時間。単位付きの正の Go duration で指定します。起動時に読み取られ、無効な値または正でない値は起動を阻止します。プロセス終了処理の時間は制限しません。
OLIVARES_SESSION_BUDGET_AVAILABILITY No — Whether session budget enforcement is required, and what happens when the budget service cannot answer.
OLIVARES_SESSION_CONTEXT_AVAILABILITY No — Whether session context governance is required, and what happens when the context service cannot answer.
OLIVARES_SESSION_KILLSWITCH_SWEEP No 15s How often an active session is re-checked against the kill switch, as a Go duration. 0 leaves only the check at launch.
OLIVARES_SESSION_PEP_TOKEN_FILE No — Path to the file holding the token the session enforcement point requires.
OLIVARES_SESSION_PEP_URL No — Base URL of the policy enforcement point a governed agent session calls before acting.
OLIVARES_SESSION_RUNTIME_BASE_URL No — Base URL the launched session runtime calls back to.
OLIVARES_SESSION_RUNTIME_CLAUDE_BIN No claude Executable the session runtime launches.
OLIVARES_SESSION_RUNTIME_CODEX_BIN No — Explicit override selecting the official Codex executable instead of the newest verified managed install or codex on the engine’s PATH. The driver is registered at boot even when unset; launch is refused if no executable resolves.
OLIVARES_SESSION_RUNTIME_GEMINI_BIN No — Pinned official Gemini CLI executable the session runtime may operate; unset, the Gemini CLI installed on this node is found when a session launches.
OLIVARES_SESSION_RUNTIME_GROK_BIN No — Explicit override selecting the official Grok executable instead of the newest verified managed install or grok on the engine’s PATH. The driver is registered at boot even when unset; launch is refused if no executable resolves.
OLIVARES_SESSION_RUNTIME_OPENCODE_BIN No — 最新の検証済み管理インストールやエンジンの PATH 上の opencode に代えて、公式 OpenCode 実行ファイルを明示的に選択します。変数が未設定でもドライバーは起動時に登録されます。実行ファイルが見つからなければ、セッションの起動を拒否します。
OLIVARES_SESSION_RUNTIME_TOKEN_FILE No — Path to the file holding the session runtime’s credential, refreshed by rotation.
OLIVARES_SESSION_RUNTIME_TOKEN_TTL No 15m Lifetime of a minted session runtime credential, as a Go duration.
OLIVARES_SESSION_RUNTIME_WIF No — Whether the session runtime takes its credential from workload identity federation instead of a token file.
OLIVARES_SESSION_RUNTIME_WIF_RULE No — Which federation rule the session runtime exchanges its workload identity under.
OLIVARES_SESSION_WORKTREE_BRANCH_PREFIX No olivares/ Prefix of the branch a session gets when it is started with a new git worktree; git checks the resulting branch name.
OLIVARES_SESSION_WORKTREE_DIR No — Directory that holds the git worktrees of sessions started with a new worktree; the default is session-worktrees in the data directory.
OLIVARES_SIEM_FORWARD_INTERVAL No — How often signed ledger records are forwarded to the configured SIEM, as a Go duration.
OLIVARES_SOURCES_CONFIG No — Path to the JSON file that wires real observation sources and identity roster providers before the engine starts.
OLIVARES_SSO_PROTOCOL No — Single sign-on protocol to wire: oidc or saml. Unset means no federation, and the endpoints report it rather than half-wiring one.
OLIVARES_SSO_SECRET_KEY No — Key that encrypts the federation client secret and service-provider private keys at rest.
OLIVARES_TARGET_BINDING_KEY No — Key that binds an orchestration target to this deployment, inline. Prefer the file form.
OLIVARES_TARGET_BINDING_KEY_FILE No — Path to the orchestration target binding key.
OLIVARES_TENANT No — Default tenant for CLI commands, when --tenant is not given.
OLIVARES_THREATINTEL_CONFIG No — Path to the JSON configuration of threat-intelligence ingest. Read by the Business edition.
OLIVARES_THREATINTEL_SIGNING_KEY No — Signing key for threat-intelligence bundles the engine publishes.
OLIVARES_TOKEN No — API token the CLI authenticates with, when no token flag such as --token-file is given.
OLIVARES_TOOL_PIN_CONFIG No — MCP ツールピンストアの任意の JSON 設定（require_pin_approval）へのパス。このストアは、この変数が設定されているかどうかに関係なく、enterprise のビルドタグ付きでコンパイルされたビルドで動作します。エンジンの起動時に読み取ります。未設定の場合は初回使用時の信頼（trust on first use）を維持します。ファイルを読み取れない場合や解析できない場合は、ファイルを修正してエンジンを再起動するまで、未知のツールにオペレーターの承認を必須にします。
OLIVARES_TOTP_SEED_KEY No — 保存時の TOTP シードを封印する、Base64 エンコードされた 32 バイト鍵。HA ノードでは同じ鍵を設定します。未設定の場合、エンジンはデータディレクトリ内に非公開の totp-seed.key を作成します。
OLIVARES_UPDATE_CHANNEL No — Release channel the update check asks for, such as stable.
OLIVARES_UPDATE_ENDPOINT No — Base URL the update check queries. Unset leaves the update check off.
OLIVARES_UPGRADE_TOKEN No — Download token olivares upgrade presents when fetching a build from a credentialed repository.
OLIVARES_VECTOR_API_KEY No — API key for the external vector index.
OLIVARES_VECTOR_BACKEND No — Which vector index backs knowledge search. Unset keeps the in-process index, which is the air-gapped default.
OLIVARES_VECTOR_DIM No — Vector dimension of the index, which has to match the embeddings model.
OLIVARES_VECTOR_DSN No — Connection string for the external vector index.
OLIVARES_VECTOR_NAMESPACE No knowledge_ann Table or collection the vector index writes to.
OLIVARES_VECTOR_TIMEOUT No — Per-request timeout for the vector index, as a Go duration.
OLIVARES_VOICE_CALL_CONFIG No — Path to the JSON configuration of the inbound voice webhook.
OLIVARES_VOICE_DISPATCH_CONFIG No — Path to the JSON configuration of outbound voice dispatch.
OLIVARES_WEBAUTHN_ORIGINS No — Comma-separated origins accepted for WebAuthn ceremonies.
OLIVARES_WEBAUTHN_RPID No — WebAuthn relying-party id for the privileged-login flow. It has to match the site’s registrable domain.
OLIVARES_WEBAUTHN_RP_NAME No — Display name of the WebAuthn relying party, as shown by the authenticator.
OLIVARES_WIF_BASE_URL No — Endpoint the workload identity exchange is performed against.
OLIVARES_WIF_REFRESH_SLACK No 60s How long before expiry a federated credential is refreshed, as a Go duration.
OLIVARES_WIF_SPIFFE_SOCKET No — Path to the SPIFFE workload API socket the engine fetches its identity from.
OLIVARES_WIF_TRUST_DOMAIN No — SPIFFE trust domain accepted for workload identity.
OLIVARES_WORK_OUTBOX_INTERVAL No — How often the work-kernel outbox is drained, as a Go duration. 0 disables the pump.
OLIVARES_WORK_TOKEN No — セッション自身の、スコープが限定された作業用認証情報。セッションランチャーが注入し、作業コマンドが読み取ります。運用担当者が指定してはいけません。値は常にマスクされます。

Variable families

Section titled “Variable families”

These prefixes name families whose member variables are built at runtime — the per-provider and per-backend keys the engine composes from a provider name. The concrete members it composes are in the table above.

Prefix Required Default What it configures
OLIVARES_AUDIT_ARCHIVE_ No — Family prefix for the audit archive settings listed above.
OLIVARES_CODEX_HOOK_ No — Family prefix for the Codex hook client and server settings listed above.
OLIVARES_DR_OFFSITE_ No — Family prefix for the offsite replication settings listed above.
OLIVARES_EMBEDDINGS No — Family stem for the unprefixed embeddings settings, which configure the OpenAI-compatible provider.
OLIVARES_EMBEDDINGS_ No — Family prefix from which the per-provider embeddings keys are built, by appending the provider name and then the setting.
OLIVARES_GROK_HOOK_ No — Family prefix for the Grok Build hook client and server settings listed above.
OLIVARES_HOOK_PEP_ No — Family prefix for the Claude Code hook client and server settings listed above.
OLIVARES_KEY_WRAP No — Family stem naming the key management backend that wraps signing keys.
OLIVARES_KEY_WRAP_ No — Family prefix from which the per-backend key-wrapping keys are built.
OLIVARES_LEDGER_KMS_ No — Business edition only. Family prefix from which the per-backend ledger signer keys are built.
OLIVARES_OIDC_ No — Family prefix for the OIDC federation settings listed above.
OLIVARES_OTEL_ No — Family prefix for the trace export settings listed above.
OLIVARES_SAML_ No — Family prefix for the SAML federation settings listed above.
OLIVARES_SECRETREF_ No — Family of settings for external secret-reference backends, including token-file references.
OLIVARES_SESSION_RUNTIME_ No — Family prefix for the session runtime settings listed above.
OLIVARES_VECTOR_ No — Family prefix for the vector index settings listed above.
OLIVARES_WIF_ No — Family prefix for the workload identity federation settings listed above.
OLIVARES_WORK_ No — Family prefix for the per-run values the engine passes into a launched work session.

ストア選択

Section titled “ストア選択”

エンジンは --engine からストアエンジンを選択します。

エンジン 使うべき場面 備考
sqlite（デフォルト） 単一バイナリ、単一ノード、エアギャップ環境のインストール。 純 Go の組み込みストア。外部依存ゼロ。--dsn がない場合、ストアファイルはデータディレクトリに置かれます。
postgres マルチテナントおよびスケールアウトのデプロイメント。 行レベルセキュリティのテナント分離を追加します。最小権限のアプリケーションロールが必要です。

SQLite はデフォルトであり、外部サービスを必要としません。postgres を選ぶと、テナントを分離する行レベルセキュリティの最後の砦をオプトインします：エンジンは、Postgres スーパーユーザーまたは BYPASSRLS ロールに対しては、そのガードが明示的にオーバーライドされない限り 起動を拒否 します。なぜなら、そのようなロールはテナント分離の最後の砦を無効化してしまうからです。Compose の Postgres オーバーレイは初回 init 時に最小権限のアプリケーションロールをプロビジョニングするため、この最後の砦は本物です。

監査チェックポイント間隔

Section titled “監査チェックポイント間隔”

監査台帳（audit ledger）は追記専用、ハッシュチェーン化（hash-chained）されており、Ed25519 署名されたチェックポイントによって固定されます。--checkpoint-interval は、すべてのテナントチェーンにわたって署名済みチェックポイントが書き込まれる頻度を制御します（デフォルト 1h、0 でチェックポイント作成を無効化）。ストアが閉じる前に最終シャットダウンチェックポイントが書き込まれるため、チェーンは間隔のときだけでなくクリーンシャットダウン時にも固定されます。署名済みエクスポートと転送のパスは 監査を Splunk に転送する でカバーされています。

セキュアなデフォルト

Section titled “セキュアなデフォルト”

これらは、serve を超える設定がない状態で有効になる姿勢です。これらは製品のデフォルトのセキュリティスタンスであり、オプションの堅牢化ではありません。

領域 デフォルト 意味するところ
認証情報 出荷なし デフォルトのユーザー名やパスワードは存在しません。ユーザーのいない初回起動時、エンジンは単回使用のセットアップトークンを発行し、それを標準出力のみに出力します — ログには決して出力しません。
初回起動セットアップ ワンタイムトークン 管理者はそのトークンで最初のユーザーを作成し、その後ログインします。トークンは一度だけ表示され、単回使用です。
トランスポート TLS オン HTTP と gRPC はデフォルトで TLS 越しに提供されます。何も供給されない場合は自己署名証明書がデータディレクトリに生成され、その証明書フィンガープリントと --pin-sha256 の値の両方がログに記録されます。
バインドアドレス すべてのインターフェース --listen と --grpc-listen はデフォルトで :8443 と :8444 です。エンジンを自ホストだけに制限するには、意図的に --listen 127.0.0.1:8443 --grpc-listen 127.0.0.1:8444 を渡します。
平文モード オフ --insecure が平文を提供する唯一の方法であり、gRPC のパスは劣化するのではなく fail closed します。ローカルホスト開発専用に意図されています。
デモシード オフ --seed-demo はデフォルトでオフであり、公開パスワードのデモ管理者を発行するため、いかなる非 loopback バインドも拒否します。
テレメトリのホームコール オフ エンジンはホームに電話をかけません。ベンダーへのテレメトリチャネルは存在せず、稼働の副作用として何かが送信されることもありません。アウトバウンド接続は、あなたが設定したソースに対して、および実行したときの olivares upgrade に対して存在します（--endpoint や --bundle で他を指さない限り更新チャネルに接続します）。これが、egress ゼロでの エアギャップインストール を可能にするものです。

初回起動、実際には

Section titled “初回起動、実際には”

新規インストールでは、エンジンはワンタイムのセットアップトークンを含む FIRST-BOOT SETUP ブロックを標準出力に出力します。管理者はそれを使って最初のユーザーを作成し、その後認証します。Docker Compose の下では、トークンはコンテナログから読み取られます：

ターミナルウィンドウ
docker compose -f deploy/compose/docker-compose.yml up -d
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)

セットアップエンドポイントとログインエンドポイントは製品の OpenAPI 契約の一部です。API リファレンス を参照してください。それらの背後にある不透明（opaque）なセッションおよび API キートークンモデルは、セキュリティモデル で説明されています。

このページがカバーしないこと

Section titled “このページがカバーしないこと”

これは検証済みの共通設定サーフェスです。マルチノードおよび相互 TLS トポロジのためのすべての高度なフラグを列挙するものでは ありません — それらは、アーキテクチャ概要 で説明され CLI リファレンス に完全に列挙される、分散およびエアギャップのデプロイメントに属します。設定が設計段階またはトポロジ固有のものである場合、それは安定したつまみとしてここに提示されるのではなく、そちらで文書化されます。

製品が観測する範囲の境界と、カバレッジがどこでティア分けされるかについては、正直さと限界 を読んでください。