Configuration
Environment variables for Lux Cloud
All Lux Cloud services are configured via environment variables.
| Variable | Description | Default |
|---|
API_KEY_SALT | Salt for API key hashing (must be secret) | -- |
DATABASE_URL | PostgreSQL connection string | -- |
REDIS_URL | Redis/Valkey for WebSocket state and caching | -- |
RPC_ENDPOINTS | Upstream luxd node endpoints (comma-separated) | -- |
PORT | API listen port | 3000 |
| Variable | Description | Default |
|---|
NEXT_PUBLIC_BRAND | Brand identifier | lux |
NEXT_PUBLIC_BRAND_NAME | Display name | Lux Cloud |
NEXT_PUBLIC_BRAND_URL | Brand website | https://lux.cloud |
| Variable | Description | Default |
|---|
RATE_LIMIT_RPC | RPC requests per minute | 600 |
RATE_LIMIT_API | REST API requests per minute | 300 |
RATE_LIMIT_WS | WebSocket messages per minute | 120 |
| Variable | Description | Default |
|---|
RPC_TIMEOUT | Request timeout (ms) | 30000 |
RPC_RETRY_COUNT | Retries on failure | 3 |
RPC_HEALTH_INTERVAL | Health check interval (ms) | 10000 |
| Variable | Description | Default |
|---|
INDEX_INTERVAL | Block polling interval (ms) | 2000 |
INDEX_BATCH_SIZE | Blocks per batch | 100 |
INDEX_START_BLOCK | Starting block number | 0 |
# Production
API_KEY_SALT=<random-32-bytes>
DATABASE_URL=postgres://cloud:pass@postgres:5432/cloud
REDIS_URL=redis://valkey:6379
RPC_ENDPOINTS=http://luxd-0:9630,http://luxd-1:9630
NEXT_PUBLIC_BRAND=lux
PORT=3000