Environment Variables Reference

Complete reference of all environment variables used to configure QBITEL Bridge. Variables are grouped by component and function.

Core Configuration

Variable Default Required Description
QBITEL_ENVIRONMENT development No Environment name (fallback: ENVIRONMENT)
QBITEL_LOG_LEVEL INFO No Logging level (DEBUG, INFO, WARNING, ERROR)
QBITEL_DB_HOST localhost No Database host (fallback: DATABASE_HOST)
QBITEL_DB_PORT 5432 No Database port (fallback: DATABASE_PORT)
QBITEL_DB_PASSWORD -- Production Database password (fallback: DATABASE_PASSWORD)
QBITEL_REDIS_PASSWORD -- No Redis password

Security & Authentication

Variable Default Required Description
QBITEL_JWT_SECRET -- Yes JWT signing secret (fallback: JWT_SECRET)
QBITEL_ENCRYPTION_KEY -- No Encryption key for field-level encryption
QBITEL_API_KEY -- No API key for authentication (fallback: API_KEY)
MARKETPLACE_ENABLED false No Enable the protocol marketplace feature

LLM Provider

Variable Default Required Description
QBITEL_LLM_PROVIDER ollama No LLM provider: ollama, vllm, localai
OLLAMA_URL http://localhost:11434 No Ollama endpoint URL
QBITEL_LLM_MODEL llama3.2:8b No Default LLM model name
QBITEL_LLM_ENDPOINT -- No Custom LLM endpoint URL
QBITEL_AIRGAPPED_MODE false No Enable air-gapped mode (no external API calls)
QBITEL_DISABLE_CLOUD_LLMS false No Disable all cloud LLM providers

Security

Variable Default Required Description
OLLAMA_URL http://localhost:11434 No Ollama LLM endpoint URL
JWT_ALGORITHM HS256 No JWT signing algorithm
JWT_EXPIRATION 3600 No JWT token expiration in seconds
API_KEY_ENABLED true No Enable API key authentication
MTLS_ENABLED false No Enable mutual TLS authentication
MTLS_CA_CERT -- If mTLS Path to CA certificate for mTLS
PQC_ENABLED true No Enable post-quantum cryptography
VAULT_ADDR -- No HashiCorp Vault server address
VAULT_TOKEN -- No Vault authentication token

Observability

Variable Default Required Description
OTEL_EXPORTER_ENDPOINT http://localhost:4317 No OpenTelemetry Collector gRPC endpoint
OTEL_SERVICE_NAME qbitel-ai-engine No Service name for telemetry
SENTRY_DSN -- No Sentry DSN for error tracking
PROMETHEUS_PORT 9091 No Prometheus metrics port

Marketplace

Variable Default Required Description
STRIPE_API_KEY -- If marketplace Stripe API key for marketplace payments
AWS_S3_BUCKET -- If marketplace S3 bucket for protocol artifact storage
AWS_ACCESS_KEY_ID -- If AWS AWS access key for S3 and cloud integrations
AWS_SECRET_ACCESS_KEY -- If AWS AWS secret key for S3 and cloud integrations

UI Console (Vite)

Variable Default Description
VITE_API_BASE_URL http://localhost:8000 Backend API URL
VITE_OIDC_AUTHORITY -- OIDC provider URL
VITE_OIDC_CLIENT_ID -- OIDC client identifier
VITE_ENABLE_MARKETPLACE true Enable protocol marketplace UI
VITE_ENABLE_MONITORING true Enable monitoring dashboards in UI

See Also