Reference · 12.07
Environment Variables Reference
Every AGENTIS_* environment variable — data directories, HTTP binding, model routing, media providers, and observability.
Env varsConfig
Core runtime
| Variable | Default / purpose |
|---|---|
AGENTIS_DATA_DIR / AGENTIS_ASSETS_DIR | Runtime state directory; content-addressed asset store. |
AGENTIS_ARCHIVE_DIR | Compressed cold archive directory. Defaults under the data directory. |
AGENTIS_HTTP_HOST / AGENTIS_HTTP_PORT | Server bind — default 127.0.0.1. |
AGENTIS_MODE | embedded or standard. |
AGENTIS_WORKFLOW_PARALLELISM | Default auto. |
AGENTIS_ALLOWED_ORIGINS / AGENTIS_PUBLIC_URL | Realtime CORS origins; public base URL. |
AGENTIS_EMBEDDING_CACHE_DIR | Model cache and persisted runtime transaction state. Defaults to <data-dir>/models. |
AGENTIS_EMBEDDING_DTYPE | q8 on fresh installs; existing fp32 vector identities are retained. |
AGENTIS_EMBEDDING_OFFLINE / AGENTIS_EMBEDDING_MODEL_PATH | Reuse a verified pre-populated cache without remote access. |
AGENTIS_STORAGE_FULL_RUN_DAYS | How long completed full run state remains hot before archive compaction. Default 7. |
AGENTIS_STORAGE_LEDGER_DAYS | How long ledger events remain hot before cold archival. Default 30. |
AGENTIS_STORAGE_OBSERVABILITY_DAYS | How long observability rows remain hot before cold archival. Default 14. |
AGENTIS_STORAGE_MAX_HOT_DB_MB / AGENTIS_STORAGE_MIN_FREE_MB | Pressure thresholds that tighten hot retention when the database or disk is getting too large. |
AGENTIS_STORAGE_MAINTENANCE_INTERVAL_MS | Background storage maintenance cadence. Default 21600000 (6 hours). |
AGENTIS_HARNESS_IMPORT_SYNC_MS | Recovery cadence for imported-agent ownership synchronization. Default 21600000 (6 hours); filesystem watchers detect normal changes sooner. Set to 0 to disable the periodic timer. |
Auth, secrets & seed
| Variable | Default / purpose |
|---|---|
AGENTIS_CREDENTIAL_KEY | Secret-vault key (AES-256-GCM). Auto-managed if unset. |
AGENTIS_JWT_PRIVATE_KEY / _PUBLIC_KEY | RS256 keypair — auto-generated by default. |
AGENTIS_SEED_USERNAME / _PASSWORD / _DISPLAY_NAME | The first operator account. Username defaults to operator. |
Models, media & observability
| Variable | Default / purpose |
|---|---|
AGENTIS_ORCHESTRATOR_MODEL / _BASE_URL / _API_KEY | Fallback orchestrator model when Settings/agent don't name one. |
AGENTIS_ORCHESTRATOR_PLANNING_* | A dedicated planning/synthesis runtime. |
AGENTIS_EVALUATOR_MODEL / _BASE_URL / _API_KEY | The verdict/evaluator runtime. |
AGENTIS_MEDIA_IMAGE_MODEL / _BASE_URL / _API_KEY | Image generation — defaults to gpt-image-1 against https://api.openai.com/v1. |
AGENTIS_BRAIN_VISION_MODEL / _TRANSCRIPTION_MODEL / _ENRICHMENT_ENABLED | Vision, transcription, and knowledge-base enrichment. |
AGENTIS_CHAT_TURN_DEADLINE_MS / _STREAM_TIMEOUT_MS | Chat turn and stream watchdogs. |
AGENTIS_EXTENSION_DOCKER / _DOCKER_POOL_SIZE / _REGISTRY_URL | Extension sandbox and registry. |
AGENTIS_OTEL_ENDPOINT / _SERVICE_NAME | Optional OpenTelemetry export — no-op tracer when unset. |
Defaults are auto-derived at setup. Agentis boots and bootstraps its first agent without hand-editing any of these — override only for a specific deployment need.
Portable components & runtime parity
| Variable | Purpose |
|---|---|
AGENTIS_COMPONENT_PYTHON_IMAGE / AGENTIS_COMPONENT_NODE_IMAGE | Override the default python:3.12-alpine and node:20-alpine Component v2 images. |
AGENTIS_COMPONENT_NETWORK / AGENTIS_COMPONENT_EGRESS_PROXY | Explicitly enable the fail-closed component network path and name its controlled egress network/proxy. |
AGENTIS_PARITY_NATIVE_JSON | Native-harness fixture results consumed by pnpm eval:runtime-parity. |
AGENTIS_PARITY_URL / _API_KEY / _WORKSPACE_ID / _AGENT_ID | Target Agentis instance and identity for the paired black-box parity evaluator. |
The evaluator requires paired native and Agentis results by default.
--allow-unpaired is a smoke-test escape hatch, not a parity claim.