Environment Variables
All environment variables recognized by Hoziron.
| Variable | Purpose | Default |
|---|
HOZIRON_HOME | Config/data directory path | ~/.hoziron |
HOZIRON_LISTEN | Daemon listen address (overrides config) | 127.0.0.1:4200 |
HOZIRON_LOG | Log level filter directives | info |
HOZIRON_LOG_FORMAT | Log output format (text or json) | text |
Provider API Keys
| Variable | Provider | Notes |
|---|
ANTHROPIC_API_KEY | Anthropic (Claude) | Required when provider is enabled |
OPENAI_API_KEY | OpenAI (GPT) | Required when provider is enabled |
GROQ_API_KEY | Groq | Required when provider is enabled |
VLLM_API_KEY | vLLM | Any non-empty string works |
Provider keys are resolved lazily at request time. Adding or removing them takes effect immediately without daemon restart.
Telemetry
| Variable | Purpose | Default |
|---|
OTEL_EXPORTER_OTLP_ENDPOINT | OpenTelemetry collector endpoint | — (disabled) |
Registry / Catalog
| Variable | Purpose | Notes |
|---|
INTERNAL_REGISTRY_TOKEN | Auth token for private registries | Name is configurable in auth_token_env |
Container-Specific
| Variable | Purpose | Notes |
|---|
HOZIRON_HOME | Critical in containers — dirs::home_dir() returns None in distroless | Set to /data |
Auth
| Variable | Purpose | Notes |
|---|
HOZIRON_PROD_KEY | API key for multi-context CLI access | Name is user-configurable |
Resolution Behavior
- Variables prefixed with
HOZIRON_ are platform configuration
- Provider key variables are named by the
api_key_env config field (customizable)
- Registry tokens are named by the
auth_token_env field per registry
- All credential variables are read lazily — never at startup
Related: