.env.example

# ── Required ──────────────────────────────────────────────────────────────────

# Gateway authentication key — clients must pass this as x-api-key or Bearer token
GATEWAY_API_KEY=your-gateway-api-key

# Database connection string. Two drivers are supported and the target is fixed
# at deploy time (it cannot be switched later without re-migrating data):
#   PostgreSQL:  postgresql://user:password@localhost:5432/ai_proxy
#   SQLite:      sqlite:./data/llm-relay.db   (embedded, no external DB needed —
#                use an absolute path like sqlite:///data/llm-relay.db in Docker
#                and mount a volume so the file persists)
DATABASE_URL=postgresql://user:password@localhost:5432/ai_proxy

# ── Optional ──────────────────────────────────────────────────────────────────

# Server port (default: 3300)
PORT=3300

# Maximum number of debug request records to retain (default: 50000)
DEBUG_DB_MAX_RECORDS=50000

# Upstream response-start timeout in milliseconds (all default to 300000 = 300s).
# These are defaults only; the console Settings page can persist runtime overrides.
UPSTREAM_DEFAULT_FIRST_BYTE_TIMEOUT_MS=300000
UPSTREAM_STREAM_FIRST_BYTE_TIMEOUT_MS=300000
UPSTREAM_IMAGE_FIRST_BYTE_TIMEOUT_MS=300000
# Legacy fallback still accepted when split first-byte variables are unset.
# UPSTREAM_REQUEST_TIMEOUT_MS=300000

# Upstream response body idle timeout in milliseconds (default: 300000 = 300s = 5min)
# Set to 0 to disable; active streaming responses are kept alive as long as chunks keep arriving
UPSTREAM_RESPONSE_IDLE_TIMEOUT_MS=300000

# Test database (used by bun test when running integration tests)
TEST_DATABASE_URL=postgresql://user:password@localhost:5432/ai_proxy_test