Status: Stub — content pending.
Status: Stub — content pending.
title: "Environment Variables"
description: "Complete reference for all obleth environment variables with types, defaults, and purpose."
All obleth configuration is done via environment variables. There are no config files.
Core listeners
| Variable | Type | Default | Purpose |
|---|
OBLETH_PROXY_LISTEN | string | 0.0.0.0:8080 | Data plane bind address |
OBLETH_ADMIN_LISTEN | string | 0.0.0.0:9090 | Management API bind address |
OBLETH_METRICS_LISTEN | string | 0.0.0.0:9091 | Prometheus metrics bind address |
Upstream
| Variable | Type | Default | Purpose |
|---|
OBLETH_UPSTREAM_BASE_URL | URL | http://127.0.0.1:8081 | Default upstream for all models without a per-model api_base |
OBLETH_UPSTREAM_TIMEOUT_SECS | integer | 300 | Upstream request timeout in seconds (covers streaming) |
Datastores
| Variable | Type | Default | Purpose |
|---|
OBLETH_REDIS_URL | URL | redis://127.0.0.1:6379 | Redis connection string |
OBLETH_DATABASE_URL | URL | postgres://obleth:obleth@localhost/obleth | Postgres connection string |
OBLETH_CLICKHOUSE_URL | URL | http://127.0.0.1:8123 | ClickHouse HTTP endpoint |
OBLETH_CLICKHOUSE_DB | string | obleth | ClickHouse database name |
OBLETH_CLICKHOUSE_USER | string | default | ClickHouse user |
OBLETH_CLICKHOUSE_PASSWORD | string | "" | ClickHouse password |
Admission and fairshare
| Variable | Type | Default | Purpose |
|---|
OBLETH_GLOBAL_MAX_IN_FLIGHT | integer | 256 | Maximum concurrent in-flight requests per pod |
OBLETH_FAIRSHARE_ALGORITHM | enum | hierarchical | Fairshare algorithm: weighted or hierarchical |
OBLETH_BROWNOUT_WAIT_MS | integer | 750 | How long a queued request waits before brownout-degradation (ms) |
Reliability
| Variable | Type | Default | Purpose |
|---|
OBLETH_FAIL_OPEN | boolean | true | Serve requests when Redis is unavailable (budget checks skipped) |
OBLETH_WAL_PATH | path | ./obleth-telemetry.wal | Path to the telemetry write-ahead log file |
Security
| Variable | Type | Default | Purpose |
|---|
OBLETH_ADMIN_TOKEN | string | dev-admin-token | Bearer token for all Management API requests. Change in production. |
Observability
| Variable | Type | Default | Purpose |
|---|
OBLETH_OTEL_ENDPOINT | URL | unset | OpenTelemetry OTLP endpoint. If unset, tracing is disabled. |
RUST_LOG | string | obleth=info | Rust log filter. Use obleth=debug for verbose output. |
Control plane
These variables apply to the obleth-control-plane Next.js service, not the gateway.
| Variable | Type | Default | Purpose |
|---|
OBLETH_ADMIN_BASE_URL | URL | http://localhost:9090 | Management API URL |
OBLETH_ADMIN_TOKEN | string | dev-admin-token | Admin token for Management API calls |
DASHBOARD_USERNAME | string | obleth | Login username |
DASHBOARD_PASSWORD | string | obleth | Login password. Change in production. |
DASHBOARD_SESSION_SECRET | string | dev-session-secret-... | NextAuth.js session signing secret. Change in production. |