Referencia de configuración

Business

La exportación de auditoría (GET /v1/audit/export, olivares audit export), los archivos en directorios y la verificación de archivos externos requieren Business. Community conserva el registro firmado, olivares audit verify y olivares dr backup; la exportación devuelve HTTP 501 o código de salida 9. El reenvío de auditoría y la transferencia DDIL entre sitios aislados también requieren Business.

Desde 0.1, las claves de firma y los archivos de configuración sellados por KMS (CMEK) requieren el binario Business. Community conserva las claves de firma aportadas por el operador y keys status. Las aserciones de custodia BYOK (OLIVARES_KEY_CUSTODY=byok) y HYOK (OLIVARES_LEDGER_CUSTODY=hyok), el firmante de checkpoints fuera del host (OLIVARES_LEDGER_SIGNER) y olivares audit key-transition requieren el binario Business; Community los rechaza con el código de salida 9. Community rechaza una instalación con CMEK antes de abrir el almacén o crear claves. Para dr backup y keys unseal, use Business con el KMS del cliente; la recuperación no requiere una licencia activa.

Esta página documenta la superficie de configuración del motor del control plane — el binario único de Go llamado olivares. Cubre los flags que acepta el subcomando serve, las variables de entorno que el motor lee al arrancar, cómo se seleccionan el almacén y el policy decision point, y los valores por defecto seguros que están en efecto sin configuración alguna.

Todo lo listado aquí está tomado de las propias definiciones de comando del motor y de su raíz de composición. Cuando un ajuste no puede confirmarse en el código fuente, no se lista. Para la postura de seguridad conceptual detrás de estos valores por defecto, consulta el modelo de seguridad; para el camino de extremo a extremo ejecutable, consulta autoalojamiento.

Filosofía de configuración

El motor se configura mediante flags y variables de entorno, no mediante un fichero de configuración inabarcable. Todas las variables que lee se enumeran más abajo, generadas a partir de las propias fuentes. Los secretos que cablean fuentes reales permanecen en ficheros en poder del operador referenciados por variable de entorno — nunca en el almacén. Los valores por defecto se eligen para fallar cerrado: TLS activado, sin credenciales por defecto y un token de un solo uso. Los enlaces son el comodín dual-stack (:8443, :8444): esto es un servidor, y el enlace nunca fue lo que lo hacía seguro.

Entrega de eventos NATS: El puente Core NATS y NATS JetStream requieren Business Identity & Scale. Community entrega los eventos dentro del proceso.

El subcomando serve

olivares serve ejecuta el servidor HTTP REST/web y el servidor gRPC en un mismo proceso, con la interfaz web servida desde el mismo origen que la API. Los flags de más abajo son las entradas de configuración verificadas de ese comando.

Flag	Por defecto	Propósito
--listen	:8443	Dirección de escucha HTTP (API REST + interfaz web embebida).
--login-trusted-proxies	$OLIVARES_LOGIN_TRUSTED_PROXIES, o vacío	CIDR de proxies de confianza solo para la limitación de intentos de inicio de sesión con contraseña. Un valor explícitamente vacío del flag anula la variable de entorno; la política de red, la sesión y la auditoría conservan el par de transporte.
--grpc-listen	:8444	Dirección de escucha gRPC (API de control-plane / ingesta de colector).
--data-dir	$OLIVARES_DATA_DIR, una instalación existente en ./olivares-data, si no $XDG_DATA_HOME/olivares o ~/.local/share/olivares	Directorio de datos: clave de firma de auditoría, material TLS y (para SQLite) el fichero del almacén.
--engine	sqlite	Motor de almacén: sqlite o postgres.
--dsn	vacío (fichero SQLite en el directorio de datos)	Cadena de conexión al almacén.
--checkpoint-interval	1h	Cada cuánto se escribe un checkpoint de auditoría firmado sobre cada cadena de tenant. 0 desactiva.
--insecure	off	Sirve HTTP/gRPC en texto plano. Peligroso; solo para desarrollo en localhost.
--seed-demo	off	Carga un estate de ejemplo sintético para demos/E2E. Se niega a arrancar en un enlace no-loopback.

TLS está activado por defecto. Sin un --tls-cert/--tls-key suministrado, el motor garantiza un certificado autofirmado en el directorio de datos una vez, por adelantado, antes de que ningún listener acepte una conexión, de modo que tanto el servidor HTTP como el gRPC usen el mismo certificado y ninguno recaiga en texto plano. Cuando genera un certificado autofirmado registra cert_fingerprint_sha256 (el resumen del certificado, lo que muestra un navegador) y pin_sha256 (el resumen del SPKI de la hoja). --pin-sha256 toma el segundo, en base64 o hex; la huella del certificado es otro resumen — se analiza sin error, 32 bytes en cualquiera de las dos escrituras, y luego falla en el handshake con TLS SPKI pin mismatch, que indica el valor que hay que usar.

--insecure es solo loopback por intención

--insecure sirve HTTP y gRPC en texto plano, lo que expondría los tokens bearer en el cable. El camino gRPC falla cerrado: fuera de --insecure el servidor se niega a construir un listener en texto plano en lugar de degradarse en silencio. Usa --insecure solo contra 127.0.0.1 durante el desarrollo local, nunca en una dirección publicada.

--seed-demo es sintético y autoprotegido

--seed-demo aprovisiona un administrador de demo con una contraseña pública del árbol de fuentes y datos de estate fabricados. Es solo para demos y E2E. El motor se niega a arrancarlo en un listener no-loopback: si --listen o --grpc-listen no son una dirección loopback, el comando sale con un error. Usa un directorio de datos desechable; nunca lo apuntes a datos reales.

Un listado completo de flags — incluidos los flags exclusivos de Postgres y de TLS mutuo usados en despliegues distribuidos — está en la referencia de CLI. Esta página documenta la superficie de configuración común; algunos flags avanzados rigen topologías multi-nodo descritas en la visión general de la arquitectura.

Variables de entorno

Los tres grupos siguientes son los que un operador encuentra primero, descritos con su comportamiento. Tras ellos aparece el inventario completo, generado a partir de las propias fuentes del motor para que no pueda quedar por detrás del binario.

Directorio de datos

Variable	Efecto
OLIVARES_DATA_DIR	Directorio de datos por defecto cuando no se da --data-dir. Sin él, el motor usa una instalación existente en ./olivares-data; si no, $XDG_DATA_HOME/olivares o ~/.local/share/olivares — nunca el directorio de trabajo actual, que es donde dejaría claves privadas.

El directorio de datos alberga la clave de firma de auditoría, el certificado y la clave TLS, y — para el motor SQLite — el fichero del almacén. Persístelo entre reinicios.

Cableado de fuentes reales

Variable	Efecto
OLIVARES_SOURCES_CONFIG	Ruta a un fichero JSON que cablea las fuentes de observación reales y los proveedores de roster de identidad antes de que arranque el motor.

OLIVARES_SOURCES_CONFIG es la única entrada a través de la cual se resuelven las fuentes de señal no-demo y los proveedores de roster de identidad. Es la configuración portadora de secretos del operador y se mantiene deliberadamente fuera del almacén. El motor la lee durante el arranque y registra cada fuente antes de que arranque el runtime.

El arranque distingue entre una variable sin establecer y un fichero configurado:

• Una variable ausente produce una configuración vacía, y el motor avisa de que no hay nada real cableado.
• Si el fichero configurado falta, no se puede leer o contiene JSON inválido, olivares serve termina con código 1. El error empieza por load sources operator config: OLIVARES_SOURCES_CONFIG e incluye refusing to start instead of silently omitting operator configuration.
• Una lista de fuentes configurada pero vacía avisa de que ningún conector ingestará, de modo que el estate corre sin tráfico en vivo, en lugar de aparentar estar sano en silencio.
• Una lista de identidad vacía avisa de que el roster permanece vacío y la sincronización de roster es un no-op.

Si has configurado un fichero, corrige la ruta, los permisos de lectura o el JSON y reinicia. El motor se niega a omitir silenciosamente la configuración del operador. Para poblar el mapa de acceso, configura al menos una fuente — consulta conectar una fuente y, para el camino cooperativo de Claude Code sobre OpenTelemetry y MCP, conectar Claude Code.

Punto de decisión de autorización (PDP)

Edición: el PDP externo es una capacidad de Business. Una compilación Community se niega a arrancar con OLIVARES_PDP_ENGINE en cedar, opa o cualquier otro valor de motor; la negativa nombra Business y termina con el código de salida 9. Sin definir, vacío o none es válido en todas las ediciones.

El policy decision point de autorización se selecciona en la raíz de composición por entorno. El motor nativo de control de acceso basado en atributos (ABAC) y el control de acceso basado en roles (RBAC) gobiernan siempre; el PDP externo, cuando se selecciona, es una capa adicional de solo restricción que nunca puede ampliar el acceso.

Variable	Efecto
OLIVARES_PDP_ENGINE	Selecciona el PDP externo: cedar, opa o none (vacío o none significa solo ABAC nativo).
OLIVARES_PDP_CEDAR_FILE	Solo motor Cedar: ruta al fichero de política Cedar del operador.
OLIVARES_PDP_OPA_URL	Solo motor OPA: URL base del endpoint de Open Policy Agent.
OLIVARES_PDP_OPA_PATH	Solo motor OPA: ruta de decisión consultada bajo ese endpoint.
OLIVARES_PDP_OPA_TOKEN	Solo motor OPA: token bearer para el endpoint de OPA.

Dos adaptadores se sientan detrás de una misma costura (seam): un evaluador Cedar embebido (el camino primario, en Go puro) y un adaptador OPA-sobre-HTTP. El operador elige un motor; ambos solo pueden restringir, nunca ampliar, la decisión que el RBAC integrado ya tomó.

Una configuración inválida del PDP externo impide construir el conjunto de módulos

Si OLIVARES_PDP_ENGINE selecciona explícitamente un motor externo cuya configuración es inválida, no se puede construir el conjunto de módulos. Los comandos que lo construyen, incluido serve, notifican un error de configuración en lugar de volver silenciosamente a la autorización exclusivamente nativa. Corrige la configuración. Un none explícito elige deliberadamente operar sin la capa externa que solo puede restringir, mientras ABAC nativo y RBAC siguen aplicándose; no es una recuperación automática ni sustituye a una política externa obligatoria.

Un selector sin definir o vacío, o none, sigue siendo válido y usa la autorización nativa. Con cedar, el nombre del fichero de política es opcional: OLIVARES_PDP_CEDAR_FILE sin definir o vacío, o un fichero legible y vacío, proporciona una superposición vacía válida. Construir el adaptador OPA no envía ninguna solicitud de red ni comprueba que su endpoint sea accesible.

Para el modelo deny-by-default, la naturaleza privilegiada de ver el grafo de acceso, y cómo se audita cada lectura de autorización, consulta el modelo de seguridad.

Configura OLIVARES_OTEL_PROVIDER_BAGGAGE_ALLOWLIST como un array JSON de reglas con los campos origin, key y values. Cada regla permite únicamente el origen HTTP(S), la clave de baggage y los valores no secretos exactos que declara. Los límites son 16 KiB de JSON, 32 reglas, ocho valores por regla y entre 1 y 64 bytes ASCII por clave o valor. La continuación de traceparent y tracestate es independiente de esta política, y la autorización del destino también lo es.

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	—	Interruptor booleano, no una ruta de archivo, del reconciliador de legal holds de largo horizonte, que aplica legal holds de Object Lock a los segmentos de auditoría archivados de los tenants con un legal hold activo. Solo lo leen los builds compilados con las etiquetas enterprise y addon_reg, al arrancar el motor; un cambio surte efecto tras un reinicio. Solo lo activa un valor que strconv.ParseBool acepte como true, como true o 1; si no se define, vale false o no se puede analizar, permanece desactivado sin error. Además, sigue desactivado salvo que el archivado de auditoría esté configurado en un sink capaz de aplicar legal holds de 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	—	Interruptor booleano, no una ruta de archivo pese al sufijo _CONFIG, del disyuntor (circuit breaker) de runtime; sus reglas por tenant no se definen aquí. Solo lo leen los builds compilados con las etiquetas enterprise y addon_airs, al arrancar el motor; un cambio surte efecto tras un reinicio. Si no se define o tiene un valor que strconv.ParseBool acepta como false, el disyuntor permanece desactivado. Un valor que no es booleano se registra como error y también lo deja desactivado. Un valor true lo activa cuando hay datos de módulo disponibles; en caso contrario, se registra una advertencia y permanece desactivado.
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	—	Credencial de comunicación propia de la sesión, inyectada por el lanzador de sesiones y leída por los comandos de mensajes. Reservada en la ruta de lanzamiento; los operadores no deben proporcionarla. Su valor siempre se oculta.
OLIVARES_COMPUTER_USE_CONFIG	No	—	Ruta al archivo JSON de políticas del gate de computer use. Solo la leen los builds compilados con las etiquetas enterprise y addon_airs. Si no se define, el gate permanece desactivado; un archivo ilegible o que no se puede analizar hace que deniegue todo computer use hasta que se corrija el archivo y se reinicie el motor.
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	—	Ruta al archivo JSON de políticas del content firewall que inspecciona el tráfico de inferencia en el proxy inline. Solo la leen los builds compilados con las etiquetas enterprise y addon_airs. Si no se define, esa inspección permanece desactivada; un archivo ilegible o que no se puede analizar hace que el firewall deniegue toda solicitud que inspeccione hasta que se corrija el archivo y se reinicie el motor.
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	—	Ruta a la configuración JSON del emisor de credenciales upstream por servidor (token exchange de RFC 8693) de la puerta de enlace MCP. Contiene secretos, por eso es un archivo y no un valor. La leen los builds compilados con la etiqueta enterprise cuando el motor arranca y construye la puerta de enlace para una URL upstream. Si no se define, se mantiene la credencial upstream estática; un archivo ilegible o que no se puede analizar deniega toda credencial upstream hasta que se corrija el archivo y se reinicie el motor.
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	—	Ruta al archivo JSON de políticas del mediador de elicitación MCP. Solo la leen los builds compilados con las etiquetas enterprise y addon_airs. Si no se define, la mediación permanece desactivada; un archivo ilegible o que no se puede analizar hace que el mediador deniegue toda elicitación hasta que se corrija el archivo y se reinicie el motor.
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	Intervalo, expresado como duración de Go, con el que el barrido de publicación Git resuelve despachos obsoletos y vuelve a observar publicaciones inciertas. 0 lo desactiva.
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	—	Interruptor de break-glass, no una ruta de archivo, para el enforcement del inicio de sesión (require-SSO y la lista de IP permitidas para el inicio de sesión). Lo lee cualquier build al arrancar el motor; un cambio surte efecto tras un reinicio. off, 0, false, no o disabled, con cualquier combinación de mayúsculas y minúsculas y sin tener en cuenta los espacios circundantes, selecciona el break-glass del operador; sin definir o con cualquier otro valor, el enforcement sigue la posture almacenada desde la consola. Un build que enlaza el componente de enforcement deja entonces de aplicar esa posture, sea cual sea la almacenada, y registra un aviso. Un build que no lo enlaza deja constancia de la misma selección deliberada: el motor omite el rechazo de arranque que haría en otro caso cuando este despliegue tiene historial de enforcement y una posture configurada, y añade un evento duradero de recuperación del operador al promover el nodo.
OLIVARES_LOGIN_TRUSTED_PROXIES	No	—	CIDR de proxies IPv4/IPv6 separados por comas, de confianza para proporcionar mediante X-Forwarded-For la dirección usada únicamente por la limitación de intentos de inicio de sesión con contraseña. Vacío no confía en ningún proxy. El flag –login-trusted-proxies tiene prioridad, incluso con un valor explícitamente vacío. Los CIDR no válidos o las entradas vacías de la lista impiden el arranque. Se lee una vez al arrancar; la política, la sesión y la auditoría conservan el par de transporte. Consulta docs/SECURITY-HARDENING.md para los límites de 8192 bytes y 64 entradas por solicitud.
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	No	disabled	Modo de activación del envío Chat síncrono gobernado. Si no se define o vale disabled, permanece desactivado; development_precheck habilita de forma explícita la comprobación previa de enrutamiento existente, no atómica y fail-open, que no es un límite monetario estricto. Cualquier otro valor impide el arranque.
OLIVARES_MODEL_GATEWAY_PROFILES_CONFIG	No	—	Ruta al archivo JSON local de perfiles de ejecución inmutables de la puerta de enlace de modelos. Si no se define, no se carga ningún perfil; un archivo ilegible o no válido impide el arranque.
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	—	Ruta a la configuración JSON del evaluador de preparación para el onboarding. La leen los builds compilados con la etiqueta enterprise cada vez que se ejecuta olivares enterprise readiness, no al arrancar el motor. {} selecciona el perfil estándar. Si no se define, o si el archivo es ilegible o no se puede analizar, ese comando informa de que la preparación para el onboarding no está configurada.
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	Tiempo máximo que puede tardar un renderizado de Chromium de un informe PDF, como duración de Go positiva con unidades. El complemento de informes lo lee en cada renderizado; un valor que no sea una duración positiva se rechaza indicando el nombre de la variable antes de iniciar Chromium. Auméntalo en hosts lentos donde un renderizado estructural supere el límite predeterminado.
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	—	Ruta a la configuración JSON del evaluador de postura poscuántica. La leen los builds compilados con la etiqueta enterprise cada vez que se ejecuta olivares enterprise pqc-posture, no al arrancar el motor. {} selecciona CNSA 2.0 con 2033 como año objetivo. Si no se define, o si el archivo es ilegible o no se puede analizar, ese comando informa de que la postura PQC no está configurada.
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	—	Ruta al archivo JSON de políticas del inspector de contenido renderizado de MCP App. Solo la leen los builds compilados con las etiquetas enterprise y addon_airs. Si no se define, esa inspección permanece desactivada; un archivo ilegible o que no se puede analizar hace que el inspector deniegue todo el contenido renderizado hasta que se corrija el archivo y se reinicie el motor.
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	—	Ruta a la configuración JSON del gobernador de retención mínima regulatoria. Solo la leen los builds compilados con las etiquetas enterprise y addon_reg, al arrancar el motor. Si no se define, no se impone ninguna retención mínima; un archivo ilegible o que no se puede analizar fija en 100 años la retención mínima de cada clase de retención hasta que se corrija el archivo y se reinicie el motor.
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	—	Ruta a la configuración JSON del coordinador de crypto-shredding para RTBF. Solo la leen los builds compilados con las etiquetas enterprise y addon_reg, al arrancar el motor. Si no se define, el crypto-shredding del open core no cambia; un archivo ilegible o que no se puede analizar bloquea todo crypto-shredding hasta que se corrija el archivo y se reinicie el motor.
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	—	Ruta al archivo JSON de concesiones (grants) del gate de egress para las herramientas de servidor del proveedor (búsqueda web, obtención web, ejecución de código) en el proxy inline. Solo la leen los builds compilados con las etiquetas enterprise y addon_airs. Si no se define, esas herramientas siguen en modo de solo observación; un archivo ilegible o que no se puede analizar deniega toda herramienta de servidor de egress reconocida hasta que se corrija el archivo y se reinicie el motor.
OLIVARES_SERVER_URL	No	—	Base URL of the engine the CLI talks to, when --server is not given.
OLIVARES_SESSIONS_AGENT_LINK_LISTEN	No	—	Dirección de escucha del enlace de agentes, en formato host:port: el endpoint con TLS mutuo que una edición basada en este árbol de fuentes ofrece a sus agentes de nodo. Se lee al arrancar; vacío, el valor predeterminado, significa que no se abre ningún listener. La compilación Community no lee esta variable.
OLIVARES_SESSIONS_MANAGED_STOP_ADMISSION_TIMEOUT	No	10s	Tiempo máximo para admitir una solicitud de Stop gestionado, expresado como una duración positiva de Go con unidades. Se lee al arrancar; un valor inválido o no positivo impide el arranque. No limita el tiempo de finalización del proceso.
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	—	Selección explícita del ejecutable oficial de OpenCode en lugar de la instalación gestionada verificada más reciente o opencode en el PATH del motor. El controlador se registra al arrancar aunque la variable no esté definida; si no encuentra un ejecutable, rechaza el lanzamiento.
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	—	Ruta a la configuración JSON opcional (require_pin_approval) del almacén de pines de herramientas MCP, que los builds compilados con la etiqueta enterprise ejecutan tanto si esta variable se define como si no. Se lee al arrancar el motor. Si no se define, se mantiene la confianza en el primer uso (trust on first use); un archivo ilegible o que no se puede analizar exige la aprobación de un operador para las herramientas desconocidas hasta que se corrija el archivo y se reinicie el motor.
OLIVARES_TOTP_SEED_KEY	No	—	Clave de 32 bytes codificada en Base64 que sella las semillas TOTP almacenadas. Usa la misma clave en los nodos HA; si no se define, el motor crea un archivo privado totp-seed.key en su directorio de datos.
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	—	Credencial de trabajo propia de la sesión, con ámbito limitado, inyectada por el lanzador de sesiones y leída por los comandos de trabajo. Los operadores no deben proporcionarla. Su valor siempre se oculta.

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.

Selección de almacén

El motor selecciona su motor de almacén desde --engine.

Motor	Cuándo usarlo	Notas
sqlite (por defecto)	Binario único, nodo único, instalaciones en entorno aislado.	Almacén embebido en Go puro; cero dependencias externas. Sin --dsn, el fichero del almacén vive en el directorio de datos.
postgres	Despliegues multi-tenant y de escalado horizontal.	Añade aislamiento de tenant con seguridad a nivel de fila. Requiere un rol de aplicación de mínimo privilegio.

SQLite es el valor por defecto y no necesita servicio externo. Elegir postgres opta por el respaldo de seguridad a nivel de fila que aísla a los tenants: el motor se niega a arrancar contra un superusuario de Postgres o un rol BYPASSRLS salvo que ese guard se sobrescriba explícitamente, porque tal rol desactivaría el respaldo de aislamiento de tenant. El overlay de Postgres de Compose aprovisiona el rol de aplicación de mínimo privilegio en la primera inicialización para que ese respaldo sea real.

El almacén por defecto es intencionadamente aburrido

SQLite no es aquí un valor por defecto de juguete. Es el almacén listo para entornos aislados, de cero dependencias, para la topología de nodo único, y es el almacén que ejecuta el despliegue de un solo comando con Docker Compose. Pásate a Postgres cuando necesites aislamiento multi-tenant o escala horizontal, no antes. Consulta autoalojamiento y la visión general de la arquitectura.

Intervalo de checkpoint de auditoría

El ledger de auditoría es append-only, hash-chained y anclado por checkpoints firmados con Ed25519. --checkpoint-interval controla cada cuánto se escribe un checkpoint firmado sobre cada cadena de tenant (por defecto 1h; 0 desactiva el checkpointing). Se escribe un checkpoint final de apagado antes de que el almacén se cierre, de modo que la cadena queda anclada también en un apagado limpio además de en el intervalo. El camino de exportación firmada y reenvío se cubre en reenviar la auditoría a Splunk.

Valores por defecto seguros

Estas son las posturas en efecto sin configuración más allá de serve. Son la postura de seguridad por defecto del producto, no un endurecimiento opcional.

Área	Por defecto	Qué significa
Credenciales	Ninguna de fábrica	No existe ningún usuario o contraseña por defecto. En el primer arranque sin usuarios, el motor acuña un token de configuración de un solo uso y lo imprime solo por salida estándar — nunca en los logs.
Configuración de primer arranque	Token de un solo uso	El administrador crea el primer usuario con ese token y luego inicia sesión. El token se muestra una vez y es de un solo uso.
Transporte	TLS activado	HTTP y gRPC sirven sobre TLS por defecto; se genera un certificado autofirmado en el directorio de datos si no se suministra ninguno, y se registran tanto su huella de certificado como su valor --pin-sha256.
Dirección de enlace	Todas las interfaces	--listen y --grpc-listen enlazan por defecto a :8443 y :8444. Restringe el motor a su propio host deliberadamente, con --listen 127.0.0.1:8443 --grpc-listen 127.0.0.1:8444.
Modo texto plano	Off	--insecure es la única forma de servir en texto plano, y el camino gRPC falla cerrado en lugar de degradarse. Pensado solo para desarrollo en localhost.
Sembrado de demo	Off	--seed-demo está desactivado por defecto y rechaza cualquier enlace no-loopback porque acuña un administrador de demo con contraseña pública.
Telemetría a casa	Off	El motor no llama a casa: no hay canal de telemetría hacia el proveedor y no se envía nada como efecto de ejecutar. Las conexiones salientes existen hacia las fuentes que configures, más olivares upgrade cuando lo ejecutas — llega al canal de actualizaciones salvo que --endpoint o --bundle lo apunten a otro sitio. Esto es lo que hace posible la instalación en entorno aislado con cero egress.

Alcanzable por defecto, restringido por intención

Los enlaces por defecto aceptan conexiones en todas las interfaces: esto es un servidor, y lo que lo protege es TLS activado, cero credenciales por defecto y un token de un solo uso. Restringirlo es la decisión deliberada del operador — --listen 127.0.0.1:8443 para el binario, OLIVARES_BIND=127.0.0.1 para el stack de Compose. Nunca emparejes un enlace no-loopback con --insecure: el motor rechaza esa combinación.

Primer arranque, en la práctica

En una instalación nueva el motor imprime un bloque FIRST-BOOT SETUP por salida estándar que contiene el token de configuración de un solo uso. El administrador lo usa para crear el primer usuario y luego se autentica. Bajo Docker Compose el token se lee de los logs del contenedor:

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)

El endpoint de configuración y el endpoint de login forman parte del contrato OpenAPI del producto; consulta la referencia de la API. El modelo de tokens opacos de sesión y de clave de API que hay detrás de ellos se describe en el modelo de seguridad.

Qué no cubre esta página

Esta es la superficie de configuración verificada y común. No enumera todos los flags avanzados para topologías multi-nodo y de TLS mutuo — esos pertenecen a los despliegues distribuidos y en entornos aislados descritos en la visión general de la arquitectura y listados en su totalidad en la referencia de CLI. Cuando un ajuste está en fase de diseño o es específico de una topología, se documenta allí en lugar de presentarse aquí como un mando estable.

Para los límites de lo que el producto observa y dónde la cobertura está escalonada por niveles, lee honestidad y límites.