.env.example

# Pulsar Relay Environment Variables
# Copy this file to .env and customize for your deployment
#
# Configuration precedence (highest to lowest):
# 1. Environment variables (this file or system env vars) - HIGHEST
# 2. Config file (config.toml or config.yaml)
# 3. Default values - LOWEST

# Note: All variables are prefixed with PULSAR_
# Example: PULSAR_STORAGE_BACKEND=valkey
#
# Note: HTTP port and workers are controlled by uvicorn at startup:
#   uvicorn pulsar_relay.main:app --host 0.0.0.0 --port 8080 --workers 4

# ============================================================================
# Server Configuration
# ============================================================================
# PULSAR_APP_NAME="Pulsar Relay"

# ============================================================================
# Storage Backend
# ============================================================================
# PULSAR_STORAGE_BACKEND=memory  # Options: memory, valkey

# ============================================================================
# Valkey Configuration
# ============================================================================
# PULSAR_VALKEY_HOST=localhost
# PULSAR_VALKEY_PORT=6379
# PULSAR_VALKEY_USE_TLS=false

# ============================================================================
# Storage Configuration
# ============================================================================
# PULSAR_PERSISTENT_TIER_RETENTION=86400
# PULSAR_MAX_MESSAGES_PER_TOPIC=1000000

# ============================================================================
# Logging
# ============================================================================
# PULSAR_LOG_LEVEL=INFO  # Options: DEBUG, INFO, WARNING, ERROR, CRITICAL

# ============================================================================
# Authentication (IMPORTANT: Change in production!)
# ============================================================================
# Generate secure key: python -c "import secrets; print(secrets.token_urlsafe(32))"
# PULSAR_JWT_SECRET_KEY=your-secret-key-here-change-in-production

# ============================================================================
# Config File Path (optional)
# ============================================================================
# Specify custom config file location
# PULSAR_CONFIG_FILE=/path/to/config.toml

# ============================================================================
# Example Production Configuration
# ============================================================================
# PULSAR_APP_NAME="Pulsar Relay Production"
# PULSAR_STORAGE_BACKEND=valkey
# PULSAR_VALKEY_HOST=valkey.example.com
# PULSAR_VALKEY_PORT=6379
# PULSAR_VALKEY_USE_TLS=true
# PULSAR_LOG_LEVEL=WARNING
# PULSAR_JWT_SECRET_KEY=REPLACE_WITH_SECURE_RANDOM_KEY