Configuration
Environment Variables
Hyperion uses environment variables to orchestrate its multi-tier stack, from vector search in Qdrant to analytics in ClickHouse.
01 — Authentication
Security & Keys
ADMIN_API_KEYMaster key for administrative access and dashboard login.
JWT_SECRETSecret used for signing dashboard authentication tokens.
02 — Infrastructure
Multi-Tier Stack
DATABASE_URLPostgreSQL connection string for persistent metadata.
REDIS_ADDREndpoint for L1 exact-match caching.
03 — Services
Internal Orchestration
EMBEDDER_ADDRgRPC endpoint for the sentence-transformer service.
INTELLIGENCE_URLURL for the background intelligence and analytics worker.
Full Reference
| Variable | Requirement | Description |
|---|---|---|
| ADMIN_API_KEY | Required | Master key for administrative access and dashboard login. |
| JWT_SECRET | Required | Secret used for signing dashboard authentication tokens. |
| CACHE_MASTER_SECRET | Required | AES-256 key for encrypting provider credentials at rest. |
| DATABASE_URL | Required | PostgreSQL connection string for persistent metadata. |
| REDIS_ADDR | Required | Endpoint for L1 exact-match caching. |
| QDRANT_ADDR | Required | Vector database for L2 semantic deduplication. |
| CLICKHOUSE_ADDR | Required | Columnar database for high-performance analytics. |
| EMBEDDER_ADDR | Required | gRPC endpoint for the sentence-transformer service. |
| INTELLIGENCE_URL | Required | URL for the background intelligence and analytics worker. |