Référence de configuration

À partir de 0.1, les clés de signature et les fichiers de configuration scellés par KMS (CMEK) nécessitent le binaire Business. Community conserve les clés de signature fournies par l’opérateur et keys status. Les assertions de custody BYOK (OLIVARES_KEY_CUSTODY=byok) et HYOK (OLIVARES_LEDGER_CUSTODY=hyok), le signataire externe des checkpoints (OLIVARES_LEDGER_SIGNER) et olivares audit key-transition nécessitent le binaire Business ; Community les refuse avec le code de sortie 9. Community refuse une installation configurée avec CMEK avant d’ouvrir le stockage ou de créer des clés. Utilisez Business avec le KMS du client pour dr backup et keys unseal ; la récupération ne nécessite aucune licence active.

Cette page documente la surface de configuration du moteur du control plane — le binaire Go unique nommé olivares. Elle couvre les drapeaux acceptés par la sous-commande serve, les variables d’environnement que le moteur lit au démarrage, la façon dont le stockage et le point de décision de politique (policy decision point) sont sélectionnés, et les valeurs par défaut sécurisées qui sont en vigueur sans aucune configuration.

Tout ce qui est listé ici est tiré des définitions de commandes propres au moteur et de sa racine de composition. Là où un paramètre ne peut pas être confirmé dans le source, il n’est pas listé. Pour la posture de sécurité conceptuelle derrière ces valeurs par défaut, voir le modèle de sécurité ; pour le chemin exécutable de bout en bout, voir l’auto-hébergement.

Distribution des événements NATS : Le pont Core NATS et NATS JetStream nécessitent Business Identity & Scale. Community distribue les événements dans le processus.

La sous-commande `serve`

olivares serve exécute le serveur HTTP REST/web et le serveur gRPC dans un seul processus, avec l’interface web servie depuis la même origine que l’API. Les drapeaux ci-dessous sont les entrées de configuration vérifiées de cette commande.

Drapeau	Défaut	Objet
`--listen`	`:8443`	Adresse d’écoute HTTP (API REST + interface web embarquée).
`--login-trusted-proxies`	`$OLIVARES_LOGIN_TRUSTED_PROXIES`, sinon vide	CIDR des proxys de confiance uniquement pour la limitation des tentatives de connexion par mot de passe. Une valeur de flag explicitement vide annule la variable d’environnement ; la politique réseau, la session et l’audit conservent le pair de transport.
`--grpc-listen`	`:8444`	Adresse d’écoute gRPC (API du control plane / d’ingestion du collecteur).
`--data-dir`	`$OLIVARES_DATA_DIR`, une installation existante dans `./olivares-data`, sinon `$XDG_DATA_HOME/olivares` ou `~/.local/share/olivares`	Répertoire de données : clé de signature d’audit, matériel TLS, et (pour SQLite) le fichier de stockage.
`--engine`	`sqlite`	Moteur de stockage : `sqlite` ou `postgres`.
`--dsn`	vide (fichier SQLite dans le répertoire de données)	Chaîne de connexion au stockage.
`--checkpoint-interval`	`1h`	Fréquence d’écriture d’un point de contrôle d’audit signé sur la chaîne de chaque tenant. `0` désactive.
`--insecure`	off	Servir HTTP/gRPC en texte clair. Dangereux ; développement localhost uniquement.
`--seed-demo`	off	Charger un parc d’exemple synthétique pour les démos/E2E. Refuse de démarrer sur une liaison non-boucle-locale.

TLS est activé par défaut. Sans --tls-cert/--tls-key fourni, le moteur s’assure une fois pour toutes, en amont, d’un certificat auto-signé dans le répertoire de données avant que tout écouteur n’accepte une connexion, de sorte que les serveurs HTTP et gRPC utilisent le même certificat et qu’aucun ne se rabat sur le texte clair. Lorsqu’il génère un certificat auto-signé, il journalise cert_fingerprint_sha256 (le condensat du certificat, celui qu’affiche un navigateur) et pin_sha256 (le condensat du SPKI du certificat feuille). --pin-sha256 prend le second, en base64 ou en hexadécimal ; l’empreinte du certificat est un autre condensat — elle est analysée sans erreur, 32 octets dans les deux écritures, puis échoue au handshake avec TLS SPKI pin mismatch, qui indique la valeur à utiliser.

Une liste complète des drapeaux — y compris les drapeaux réservés à Postgres et au TLS mutuel utilisés dans les déploiements distribués — est dans la référence CLI. Cette page documente la surface de configuration commune ; certains drapeaux avancés régissent les topologies multi-nœuds décrites dans l’aperçu de l’architecture.

Variables d’environnement

Les trois groupes suivants sont ceux qu’un opérateur rencontre d’abord, décrits avec leur comportement. L’inventaire complet leur fait suite, généré à partir des sources propres au moteur afin qu’il ne puisse pas prendre de retard sur le binaire.

Répertoire de données

Variable	Effet
`OLIVARES_DATA_DIR`	Répertoire de données par défaut lorsque `--data-dir` n’est pas fourni. À défaut, le moteur utilise une installation existante dans `./olivares-data`, sinon `$XDG_DATA_HOME/olivares` ou `~/.local/share/olivares` — jamais le répertoire de travail courant, où il laisserait des clés privées.

Le répertoire de données contient la clé de signature d’audit, le certificat et la clé TLS, et — pour le moteur SQLite — le fichier de stockage. Conservez-le entre les redémarrages.

Câbler les sources réelles

Variable	Effet
`OLIVARES_SOURCES_CONFIG`	Chemin vers un fichier JSON qui câble les sources d’observation réelles et les fournisseurs de roster d’identités avant le démarrage du moteur.

OLIVARES_SOURCES_CONFIG est l’unique entrée par laquelle les sources de signaux non-démo et les fournisseurs de roster d’identités sont résolus. C’est la configuration porteuse de secrets de l’opérateur et elle est délibérément tenue hors du stockage. Le moteur la lit pendant le démarrage et enregistre chaque source avant le démarrage du runtime.

Le démarrage distingue une variable non définie d’un fichier configuré :

Une variable manquante produit une configuration vide, et le moteur avertit que rien de réel n’est câblé.
Si le fichier configuré est absent, illisible ou contient du JSON invalide, olivares serve se termine avec le code 1. L’erreur commence par load sources operator config: OLIVARES_SOURCES_CONFIG et contient refusing to start instead of silently omitting operator configuration.
Une liste de sources configurée-mais-vide avertit qu’aucun connecteur n’ingérera, de sorte que le parc fonctionne sans trafic en direct, plutôt que de paraître silencieusement en bonne santé.
Une liste d’identités vide avertit que le roster reste vide et que la synchronisation du roster est sans effet (no-op).

Pour un fichier configuré, corrigez le chemin, les droits de lecture ou le JSON, puis redémarrez. Le moteur refuse d’omettre silencieusement la configuration de l’opérateur. Pour peupler la carte d’accès (access map), configurez au moins une source — voir connecter une source et, pour le chemin coopératif de Claude Code via OpenTelemetry et MCP, connecter Claude Code.

Point de décision d’autorisation (PDP)

Édition : le PDP externe est une capacité Business. Un build Community refuse de démarrer lorsque OLIVARES_PDP_ENGINE vaut cedar, opa ou toute autre valeur de moteur ; le refus nomme Business et se termine avec le code de sortie 9. Non défini, vide ou none est valide dans toutes les éditions.

Le point de décision de politique d’autorisation est sélectionné à la racine de composition par l’environnement. Le moteur natif de contrôle d’accès basé sur les attributs (ABAC) et le contrôle d’accès basé sur les rôles (RBAC) gouvernent toujours ; le PDP externe, lorsqu’il est sélectionné, est une couche supplémentaire restreignant uniquement (restrict-only) qui ne peut jamais élargir l’accès.

Variable	Effet
`OLIVARES_PDP_ENGINE`	Sélectionne le PDP externe : `cedar`, `opa` ou `none` (vide ou `none` signifie ABAC natif uniquement).
`OLIVARES_PDP_CEDAR_FILE`	Moteur Cedar uniquement : chemin vers le fichier de politique Cedar de l’opérateur.
`OLIVARES_PDP_OPA_URL`	Moteur OPA uniquement : URL de base de l’endpoint Open Policy Agent.
`OLIVARES_PDP_OPA_PATH`	Moteur OPA uniquement : chemin de décision interrogé sous cet endpoint.
`OLIVARES_PDP_OPA_TOKEN`	Moteur OPA uniquement : jeton bearer pour l’endpoint OPA.

Deux adaptateurs se trouvent derrière une même couture (seam) : un évaluateur Cedar embarqué (le chemin primaire, pur-Go) et un adaptateur OPA-sur-HTTP. L’opérateur choisit un moteur ; tous deux ne peuvent que restreindre, jamais élargir, la décision que le RBAC intégré a déjà prise.

Si OLIVARES_PDP_ENGINE sélectionne explicitement un moteur externe dont la configuration est invalide, l’ensemble des modules ne peut pas être construit. Les commandes qui le construisent, dont serve, signalent une erreur de configuration au lieu de revenir silencieusement à l’autorisation native seule. Corrigez la configuration. Un none explicite choisit délibérément de fonctionner sans la couche externe qui ne peut que restreindre, tandis que l’ABAC natif et le RBAC restent appliqués ; ce n’est ni un repli automatique ni un remplacement d’une politique externe obligatoire.

Un sélecteur non défini ou vide, ou none, reste valide et utilise l’autorisation native. Avec cedar, le nom du fichier de politique est facultatif : un OLIVARES_PDP_CEDAR_FILE non défini ou vide, ou un fichier lisible et vide, fournit une surcouche vide valide. Construire l’adaptateur OPA n’envoie aucune requête réseau et ne vérifie pas que son point de terminaison est joignable.

Pour le modèle deny-by-default (refus par défaut), la nature privilégiée de la consultation du graphe d’accès, et la façon dont chaque lecture d’autorisation est auditée, voir le modèle de sécurité.

Définissez OLIVARES_OTEL_PROVIDER_BAGGAGE_ALLOWLIST comme un tableau JSON de règles avec les champs origin, key et values. Chaque règle autorise uniquement l’origine HTTP(S), la clé de baggage et les valeurs non secrètes exactes qu’elle déclare. Les limites sont de 16 Kio de JSON, 32 règles, huit valeurs par règle et 1 à 64 octets ASCII par clé ou valeur. La continuation de traceparent et de tracestate est distincte de cette politique, tout comme l’autorisation de destination.

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	—	Interrupteur booléen, et non un chemin de fichier, du réconciliateur de legal holds à long horizon, qui pose des legal holds Object Lock sur les segments d’audit archivés des tenants soumis à un legal hold actif. Seuls les builds compilés avec les tags `enterprise` et `addon_reg` le lisent, au démarrage du moteur ; une modification prend effet après un redémarrage. Seule une valeur que `strconv.ParseBool` accepte comme true, par exemple `true` ou `1`, l’active ; une variable non définie, une valeur false ou une valeur non analysable le laisse désactivé sans erreur. Il reste aussi désactivé tant que l’archive d’audit n’est pas configurée sur un sink capable de poser des legal holds Object Lock.
`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	—	Interrupteur booléen, et non un chemin de fichier malgré le suffixe `_CONFIG`, du disjoncteur (circuit breaker) du runtime ; ses règles par tenant ne se définissent pas ici. Seuls les builds compilés avec les tags `enterprise` et `addon_airs` le lisent, au démarrage du moteur ; une modification prend effet après un redémarrage. Une variable non définie ou une valeur que `strconv.ParseBool` accepte comme false laisse le disjoncteur désactivé. Une valeur qui n’est pas booléenne est journalisée comme erreur et le laisse aussi désactivé. Une valeur true l’active lorsque des données de module sont disponibles ; sinon, un avertissement est journalisé et il reste désactivé.
`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	—	Informations d’authentification de la session pour la communication, injectées par le lanceur de sessions et lues par les commandes de messagerie. Réservées sur le chemin de lancement ; les opérateurs ne doivent pas les fournir. Leur valeur est toujours masquée.
`OLIVARES_COMPUTER_USE_CONFIG`	No	—	Chemin du fichier de politique JSON du gate de computer use. Seuls les builds compilés avec les tags `enterprise` et `addon_airs` le lisent. Si la variable n’est pas définie, le gate reste désactivé ; un fichier illisible ou impossible à analyser lui fait refuser tout computer use jusqu’à ce que le fichier soit corrigé et le moteur redémarré.
`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	—	Chemin du fichier de politique JSON du content firewall qui inspecte le trafic d’inférence dans le proxy inline. Seuls les builds compilés avec les tags `enterprise` et `addon_airs` le lisent. Si la variable n’est pas définie, cette inspection reste désactivée ; un fichier illisible ou impossible à analyser fait refuser au firewall chaque requête qu’il inspecte jusqu’à ce que le fichier soit corrigé et le moteur redémarré.
`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	—	Chemin de la configuration JSON de l’émetteur d’identifiants upstream par serveur (token exchange RFC 8693) de la passerelle MCP. Elle contient des secrets, c’est pourquoi il s’agit d’un fichier plutôt que d’une valeur. Les builds compilés avec le tag `enterprise` le lisent lorsque le moteur démarre et construit la passerelle pour une URL upstream. Si la variable n’est pas définie, l’identifiant upstream statique est conservé ; un fichier illisible ou impossible à analyser refuse tout identifiant upstream jusqu’à ce que le fichier soit corrigé et le moteur redémarré.
`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	—	Chemin du fichier de politique JSON du médiateur d’élicitation MCP. Seuls les builds compilés avec les tags `enterprise` et `addon_airs` le lisent. Si la variable n’est pas définie, la médiation reste désactivée ; un fichier illisible ou impossible à analyser fait refuser au médiateur chaque élicitation jusqu’à ce que le fichier soit corrigé et le moteur redémarré.
`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`	Intervalle, exprimé en durée Go, auquel le balayage des publications Git clôt les envois périmés et observe à nouveau les publications incertaines. `0` le désactive.
`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	—	Interrupteur break-glass, et non un chemin de fichier, de l’application des règles de connexion (require-SSO et la liste d’adresses IP autorisées pour la connexion). Tous les builds le lisent au démarrage du moteur ; une modification prend effet après un redémarrage. `off`, `0`, `false`, `no` ou `disabled`, quelle que soit la casse et sans tenir compte des espaces alentour, sélectionne le break-glass de l’exploitant ; non défini ou toute autre valeur laisse l’application suivre la posture enregistrée depuis la console. Un build qui lie le composant d’application cesse alors d’appliquer cette posture, quelle qu’elle soit, et journalise un avertissement. Un build qui ne le lie pas consigne la même sélection délibérée : le moteur ignore le refus de démarrage qu’il opposerait sinon lorsque ce déploiement possède un historique d’application et une posture configurée, et ajoute un événement durable de récupération par l’exploitant lors de la promotion du nœud.
`OLIVARES_LOGIN_TRUSTED_PROXIES`	No	—	CIDR de proxys IPv4/IPv6 séparés par des virgules, autorisés à fournir via X-Forwarded-For l’adresse utilisée uniquement pour limiter les tentatives de connexion par mot de passe. Une valeur vide ne fait confiance à aucun proxy. Le flag –login-trusted-proxies est prioritaire, même avec une valeur explicitement vide. Des CIDR invalides ou des entrées de liste vides empêchent le démarrage. Lu une seule fois au démarrage ; la politique, la session et l’audit conservent le pair de transport. Voir docs/SECURITY-HARDENING.md pour les limites de 8192 octets et de 64 entrées par requête.
`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`	Non	`disabled`	Mode d’activation de l’envoi Chat synchrone gouverné. Une valeur absente ou `disabled` le maintient désactivé ; `development_precheck` active explicitement le précontrôle de routage existant, non atomique et fail-open, et ne constitue pas un budget monétaire strict. Toute autre valeur empêche le démarrage.
`OLIVARES_MODEL_GATEWAY_PROFILES_CONFIG`	Non	—	Chemin du fichier JSON local contenant les profils d’exécution immuables de la passerelle de modèles. Si la variable n’est pas définie, aucun profil n’est chargé ; un fichier illisible ou non valide empêche le démarrage.
`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	—	Chemin de la configuration JSON de l’évaluateur de préparation à l’onboarding. Les builds compilés avec le tag `enterprise` le lisent à chaque exécution de `olivares enterprise readiness`, et non au démarrage du moteur. `{}` sélectionne le profil standard. Si la variable n’est pas définie, ou si le fichier est illisible ou impossible à analyser, cette commande indique que la préparation à l’onboarding n’est pas configurée.
`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`	Durée maximale d’un rendu Chromium d’un rapport PDF, sous forme de durée Go positive avec unité. Le module complémentaire de rapports la lit à chaque rendu ; une valeur qui n’est pas une durée positive est refusée en nommant la variable avant le démarrage de Chromium. Augmentez-la sur les hôtes lents lorsqu’un rendu structurel dépasse la limite par défaut.
`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	—	Chemin de la configuration JSON de l’évaluateur de posture post-quantique. Les builds compilés avec le tag `enterprise` le lisent à chaque exécution de `olivares enterprise pqc-posture`, et non au démarrage du moteur. `{}` sélectionne CNSA 2.0 avec 2033 comme année cible. Si la variable n’est pas définie, ou si le fichier est illisible ou impossible à analyser, cette commande indique que la posture PQC n’est pas configurée.
`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	—	Chemin du fichier de politique JSON de l’inspecteur du contenu MCP App rendu. Seuls les builds compilés avec les tags `enterprise` et `addon_airs` le lisent. Si la variable n’est pas définie, cette inspection reste désactivée ; un fichier illisible ou impossible à analyser fait refuser à l’inspecteur tout contenu rendu jusqu’à ce que le fichier soit corrigé et le moteur redémarré.
`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	—	Chemin de la configuration JSON du gouverneur des durées minimales de rétention réglementaires. Seuls les builds compilés avec les tags `enterprise` et `addon_reg` le lisent, au démarrage du moteur. Si la variable n’est pas définie, aucune durée minimale de rétention n’est imposée ; un fichier illisible ou impossible à analyser fixe à 100 ans la durée minimale de chaque classe de rétention jusqu’à ce que le fichier soit corrigé et le moteur redémarré.
`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	—	Chemin de la configuration JSON du coordinateur de crypto-shredding RTBF. Seuls les builds compilés avec les tags `enterprise` et `addon_reg` le lisent, au démarrage du moteur. Si la variable n’est pas définie, le crypto-shredding de l’open core reste inchangé ; un fichier illisible ou impossible à analyser bloque tout crypto-shredding jusqu’à ce que le fichier soit corrigé et le moteur redémarré.
`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	—	Chemin du fichier JSON d’autorisations (grants) du gate d’egress pour les server tools du fournisseur (recherche web, récupération web, exécution de code) dans le proxy inline. Seuls les builds compilés avec les tags `enterprise` et `addon_airs` le lisent. Si la variable n’est pas définie, ces outils restent en observation seule ; un fichier illisible ou impossible à analyser refuse chaque server tool d’egress reconnu jusqu’à ce que le fichier soit corrigé et le moteur redémarré.
`OLIVARES_SERVER_URL`	No	—	Base URL of the engine the CLI talks to, when `--server` is not given.
`OLIVARES_SESSIONS_AGENT_LINK_LISTEN`	No	—	Adresse d’écoute de la liaison des agents, au format `host:port` : le point de terminaison avec TLS mutuel qu’une édition construite à partir de cet arbre de sources fournit à ses agents de nœud. Lue au démarrage ; une valeur vide, par défaut, signifie qu’aucun listener n’est ouvert. La version Community ne lit pas cette variable.
`OLIVARES_SESSIONS_MANAGED_STOP_ADMISSION_TIMEOUT`	No	`10s`	Durée maximale pour admettre une demande de Stop géré, exprimée comme une durée Go positive avec une unité. Lue au démarrage ; une valeur invalide ou non positive empêche le démarrage. Ne limite pas la durée de terminaison du processus.
`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	—	Sélection explicite de l’exécutable officiel OpenCode à la place de l’installation gérée vérifiée la plus récente ou de `opencode` dans le `PATH` du moteur. Le pilote est enregistré au démarrage même sans cette variable ; si aucun exécutable n’est trouvé, le lancement est refusé.
`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	—	Chemin de la configuration JSON facultative (`require_pin_approval`) du magasin d’épinglage des outils MCP, que les builds compilés avec le tag `enterprise` exécutent que cette variable soit définie ou non. La variable est lue au démarrage du moteur. Si elle n’est pas définie, la confiance au premier usage (trust on first use) est conservée ; un fichier illisible ou impossible à analyser exige l’approbation d’un opérateur pour les outils inconnus jusqu’à ce que le fichier soit corrigé et le moteur redémarré.
`OLIVARES_TOTP_SEED_KEY`	No	—	Clé de 32 octets encodée en Base64 qui scelle les secrets TOTP stockés. Définissez la même clé sur les nœuds HA ; si elle n’est pas définie, le moteur crée un fichier privé totp-seed.key dans son répertoire de données.
`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	—	Informations d’authentification de travail propres à la session, à périmètre limité, injectées par le lanceur de sessions et lues par les commandes de travail. Les opérateurs ne doivent pas les fournir. Leur valeur est toujours masquée.

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.

Sélection du stockage

Le moteur sélectionne son moteur de stockage à partir de --engine.

Moteur	Quand l’utiliser	Notes
`sqlite` (défaut)	Binaire unique, nœud unique, installations en environnement isolé.	Stockage embarqué pur-Go ; zéro dépendance externe. Sans `--dsn`, le fichier de stockage vit dans le répertoire de données.
`postgres`	Déploiements multi-tenant et à montée en charge.	Ajoute l’isolation de tenant par sécurité au niveau des lignes (row-level security). Requiert un rôle applicatif à moindre privilège.

SQLite est le défaut et ne nécessite aucun service externe. Choisir postgres souscrit au filet de sécurité par sécurité au niveau des lignes qui isole les tenants : le moteur refuse de démarrer contre un superutilisateur Postgres ou un rôle BYPASSRLS sauf si ce garde-fou est explicitement contourné, car un tel rôle désactiverait le filet de sécurité d’isolation des tenants. L’overlay Postgres de Compose provisionne le rôle applicatif à moindre privilège au premier init pour que ce filet de sécurité soit réel.

Intervalle des points de contrôle d’audit

Le registre d’audit est en ajout seul (append-only), chaîné par hachage (hash-chained), et ancré par des points de contrôle signés en Ed25519. --checkpoint-interval contrôle la fréquence d’écriture d’un point de contrôle signé sur la chaîne de chaque tenant (défaut 1h ; 0 désactive les points de contrôle). Un point de contrôle final d’arrêt est écrit avant la fermeture du stockage, de sorte que la chaîne est ancrée à l’arrêt propre aussi bien que sur l’intervalle. Le chemin d’export signé et de transfert est traité dans transférer l’audit vers Splunk.

Valeurs par défaut sécurisées

Ce sont les postures en vigueur sans aucune configuration au-delà de serve. Ce sont la position de sécurité par défaut du produit, pas un durcissement optionnel.

Domaine	Défaut	Ce que cela signifie
Identifiants	Aucun livré	Aucun nom d’utilisateur ni mot de passe par défaut n’existe. Au premier démarrage sans utilisateurs, le moteur émet un jeton de configuration à usage unique et l’affiche sur la sortie standard uniquement — jamais dans les journaux.
Configuration au premier démarrage	Jeton à usage unique	L’administrateur crée le premier utilisateur avec ce jeton, puis se connecte. Le jeton est affiché une fois et est à usage unique.
Transport	TLS activé	HTTP et gRPC servent sur TLS par défaut ; un certificat auto-signé est généré dans le répertoire de données si aucun n’est fourni, et son empreinte de certificat ainsi que sa valeur `--pin-sha256` sont journalisées.
Adresse de liaison	Toutes les interfaces	`--listen` et `--grpc-listen` se lient par défaut à `:8443` et `:8444`. Restreignez le moteur à son propre hôte délibérément, avec `--listen 127.0.0.1:8443 --grpc-listen 127.0.0.1:8444`.
Mode texte clair	Off	`--insecure` est le seul moyen de servir en texte clair, et le chemin gRPC échoue en mode fermé plutôt que de se rétrograder. Destiné au développement localhost uniquement.
Amorçage de démo	Off	`--seed-demo` est désactivé par défaut et refuse toute liaison non-boucle-locale parce qu’il émet un administrateur de démo à mot de passe public.
Télémétrie « phone home »	Off	Le moteur ne « rappelle pas à la maison » : il n’existe aucun canal de télémétrie vers l’éditeur, et rien n’est envoyé comme effet de bord de l’exécution. Les connexions sortantes existent vers les sources que vous configurez, plus `olivares upgrade` lorsque vous le lancez — il joint le canal de mises à jour sauf si `--endpoint` ou `--bundle` le pointe ailleurs. C’est ce qui rend possible l’installation en environnement isolé avec zéro sortie (egress).

Premier démarrage, en pratique

Sur une installation neuve, le moteur affiche un bloc FIRST-BOOT SETUP sur la sortie standard contenant le jeton de configuration à usage unique. L’administrateur l’utilise pour créer le premier utilisateur, puis s’authentifie. Sous Docker Compose, le jeton est lu depuis les journaux du conteneur :

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'
# puis ouvrez https://localhost:8443 (TLS auto-signé par défaut)

L’endpoint de configuration et l’endpoint de connexion font partie du contrat OpenAPI du produit ; voir la Référence de l’API. Le modèle de jetons opaques de session et de clé d’API qui les sous-tend est décrit dans le modèle de sécurité.

Ce que cette page ne couvre pas

C’est la surface de configuration commune et vérifiée. Elle n’énumère pas chaque drapeau avancé pour les topologies multi-nœuds et à TLS mutuel — ceux-ci appartiennent aux déploiements distribués et en environnement isolé décrits dans l’aperçu de l’architecture et listés en intégralité dans la référence CLI. Là où un paramètre est en phase de conception ou spécifique à une topologie, il y est documenté plutôt que présenté ici comme un réglage stable.

Pour les limites de ce que le produit observe et l’endroit où la couverture est échelonnée, lisez honnêteté et limites.