VoxCore reads configuration from a .env file at the project root. All variables have sensible defaults for local development.
Core settings
| Variable | Default | Description |
|---|
VOXBRIDGE_CONFIG_URL | http://localhost:8080/api/v1/config | VoxBridge config API base URL |
VOXCORE_SECRET | voxcore-internal-secret | Shared secret for VoxBridge ↔ VoxCore auth |
MAX_CONCURRENT_CALLS | 5 | Max concurrent calls per worker. Formula: 1 CPU core ≈ 5 calls. |
VOXCORE_WORKERS | 4 | Number of workers (reported in health endpoint, not used for spawning) |
AUDIO_SAMPLE_RATE | 8000 | Default audio sample rate (Hz) |
LOG_LEVEL | INFO | Logging level (DEBUG, INFO, WARNING, ERROR) |
Object storage
| Variable | Default | Description |
|---|
MINIO_ENDPOINT | localhost:9000 | S3-compatible endpoint |
MINIO_ACCESS_KEY | minioadmin | Access key |
MINIO_SECRET_KEY | minioadmin | Secret key |
MINIO_BUCKET | recordings | Bucket for call recordings |
MINIO_SECURE | false | Use HTTPS for storage endpoint |
LiveKit (SIP transports)
| Variable | Default | Description |
|---|
LIVEKIT_URL | (empty) | LiveKit server URL (e.g., wss://livekit.example.com) |
LIVEKIT_API_KEY | (empty) | LiveKit API key |
LIVEKIT_API_SECRET | (empty) | LiveKit API secret |
LiveKit variables are only required if using LiveKit SIP inbound or outbound transports. The WebSocket and Exotel transports do not need them.
OpenTelemetry
| Variable | Default | Description |
|---|
OTEL_ENABLED | false | Enable OpenTelemetry tracing |
OTEL_ENDPOINT | http://localhost:4317 | OTLP exporter endpoint |
OTEL_SERVICE_NAME | voxcore | Service name in traces |
API keys
STT, LLM, and TTS API keys can be set in environment variables but are typically provided through bot config from VoxBridge:
| Variable | Service |
|---|
DEEPGRAM_API_KEY | Deepgram STT |
SONIOX_API_KEY | Soniox STT |
OPENAI_API_KEY | OpenAI LLM |
GOOGLE_API_KEY | Google Gemini LLM |
ELEVENLABS_API_KEY | ElevenLabs TTS |
SARVAM_API_KEY | Sarvam TTS |
Production example
VOXBRIDGE_CONFIG_URL=https://api.vohci.com/api/v1/config
VOXCORE_SECRET=your-secret-here
MAX_CONCURRENT_CALLS=5
VOXCORE_WORKERS=4
AUDIO_SAMPLE_RATE=8000
LOG_LEVEL=info
MINIO_ENDPOINT=sgp1.digitaloceanspaces.com
MINIO_BUCKET=vohci-matrix
MINIO_SECURE=true
LIVEKIT_URL=wss://livekit.vohci.com
OTEL_ENABLED=false