Configuration Reference.

Aurora is configured through environment variables.

Variable

Default

Description

Server

PORT8080

Server port

BASE_PATH/

Mount path prefix

BODY_SIZE_LIMIT10MB

Request body size limit

SWAGGER_ENABLEDfalse

Enable Swagger UI

PPROF_ENABLEDfalse

Enable pprof endpoints

Auth

AURORA_MASTER_KEY(none)

API key for authentication

UNSAFE_MODEfalse

Run without auth when no master key

ENABLE_PASSTHROUGH_ROUTEStrue

Enable provider-native passthrough

ALLOW_PASSTHROUGH_V1_ALIASfalse

Enable /p/{provider}/v1/... alias

ENABLED_PASSTHROUGH_PROVIDERSopenai,anthropic,openrouter,zai,vllm

Passthrough providers

Storage

STORAGE_TYPEsqlite

Storage backend (sqlite, postgresql, mongodb)

STORAGE_POSTGRES_DSN(none)

PostgreSQL connection string

STORAGE_MONGO_URI(none)

MongoDB connection URI

Caching

CACHE_EXACT_ENABLEDfalse

Enable L1 exact-match cache

CACHE_EXACT_REDIS_URLredis://localhost:6379

Redis URL for cache

CACHE_SEMANTIC_ENABLEDfalse

Enable L2 semantic cache

CACHE_SEMANTIC_BACKENDqdrant

Vector store backend

CACHE_SEMANTIC_SIMILARITY0.92

Similarity threshold

CACHE_SEMANTIC_TTL3600

Cache TTL in seconds

Logging & Audit

LOGGING_ENABLEDfalse

Enable audit logging

LOGGING_INCLUDE_BODIESfalse

Include request bodies in logs

LOGGING_INCLUDE_HEADERSfalse

Include headers in logs

LOGGING_BUFFER_SIZE100

Audit log buffer size

LOGGING_FLUSH_INTERVAL5s

Flush interval

LOGGING_RETENTION30d

Log retention period

Usage Tracking

USAGE_ENABLEDtrue

Enable usage tracking

USAGE_BUFFER_SIZE100

Usage buffer size

USAGE_FLUSH_INTERVAL5s

Usage flush interval

USAGE_RETENTION90d

Usage data retention

Budgets

BUDGETS_ENABLEDtrue

Enable budget enforcement

SET_BUDGET_DEFAULT_MONTHLY(none)

Default monthly budget

Guardrails

GUARDRAILS_ENABLEDfalse

Enable guardrails pipeline

GUARDRAILS_BATCH_SIZE10

Guardrail batch processing size

Fallback / Failover

FALLBACK_DEFAULT_MODEoff

Default fallback mode (off, manual, auto)

FALLBACK_MANUAL_RULES_PATH(none)

Path to fallback rules JSON

Resilience

RETRY_MAX_ATTEMPTS3

Maximum retry attempts

RETRY_INITIAL_BACKOFF1s

Initial backoff duration

RETRY_MAX_BACKOFF30s

Maximum backoff duration

RETRY_BACKOFF_FACTOR2.0

Backoff multiplier

RETRY_JITTER_FACTOR0.1

Random jitter factor

CIRCUIT_BREAKER_THRESHOLD5

Failure count to open circuit

CIRCUIT_BREAKER_SUCCESS_THRESHOLD2

Success count to close circuit

CIRCUIT_BREAKER_TIMEOUT30s

Circuit breaker timeout

Metrics

METRICS_ENABLEDfalse

Enable Prometheus metrics

METRICS_PATH/metrics

Metrics endpoint path

Providers

OPENAI_API_KEY(none)

OpenAI API key

ANTHROPIC_API_KEY(none)

Anthropic API key

GEMINI_API_KEY(none)

Google Gemini API key

DEEPSEEK_API_KEY(none)

DeepSeek API key

GROQ_API_KEY(none)

Groq API key

OPENROUTER_API_KEY(none)

OpenRouter API key

ZAI_API_KEY(none)

Z.ai API key

XAI_API_KEY(none)

xAI (Grok) API key

AZURE_API_KEY(none)

Azure OpenAI API key

AZURE_BASE_URL(none)

Azure endpoint URL

ORACLE_API_KEY(none)

Oracle API key

ORACLE_BASE_URL(none)

Oracle endpoint URL

OLLAMA_BASE_URLhttp://localhost:11434

Ollama endpoint URL

VLLM_BASE_URL(none)

vLLM endpoint URL

MINIMAX_API_KEY(none)

MiniMax API key