.env.example

# Application Settings
PROJECT_NAME="FastAPI Template"
SECRET_KEY="changethis"
ENVIRONMENT="local"
FIRST_SUPERUSER="admin@example.com"
FIRST_SUPERUSER_PASSWORD="changethis"
FRONTEND_HOST="http://localhost:5173"
# Comma-separated Host header allowlist enforced by TrustedHostMiddleware in
# production (e.g. "api.example.com,example.com"). Ignored outside production,
# where all hosts are allowed for local dev. The frontend host is added
# automatically.
ALLOWED_HOSTS=""

# Host address Docker binds the DB/Redis ports to. Defaults to loopback
# (127.0.0.1) so they are not exposed on the host's network interfaces. Set to
# 0.0.0.0 or a specific IP only if you need external access.
DOCKER_BIND_HOST="127.0.0.1"

# Database Settings
POSTGRES_SERVER="localhost"
POSTGRES_PORT=5432
POSTGRES_USER="postgres"
POSTGRES_PASSWORD="changethis"
POSTGRES_DB="app"
# Connection pool (per process). When scaling out, keep
# (DB_POOL_SIZE + DB_MAX_OVERFLOW) × workers × replicas ≤ Postgres max_connections.
DB_POOL_SIZE=20
DB_MAX_OVERFLOW=10
DB_POOL_TIMEOUT=30

# Redis Cache Settings
REDIS_URL="redis://localhost:6379/0"

# Email / SMTP Settings (Optional)
SMTP_HOST="smtp.example.com"
SMTP_PORT=465
SMTP_USE_STARTTLS=True
SMTP_USE_SSL=False
SMTP_USER="smtp_username"
SMTP_PASSWORD="smtp_password"
EMAILS_FROM_EMAIL="noreply@example.com"

# Cloudinary (file/avatar uploads). Required to use POST /upload.
CLOUDINARY_CLOUD_NAME=
CLOUDINARY_API_KEY=
CLOUDINARY_API_SECRET=
CLOUDINARY_UPLOAD_FOLDER="uploads"
# Max upload size in bytes (default 5 MB). Uploads above this are rejected.
MAX_UPLOAD_SIZE_BYTES=5242880

# Sentry (only initialized when ENVIRONMENT != "local")
SENTRY_DSN=

# Prometheus /metrics bearer token. Required outside ENVIRONMENT="local"; without
# it /metrics returns 404. Configure your scraper with: Authorization: Bearer <token>
METRICS_TOKEN=

# OpenTelemetry tracing (opt-in). Leave OTEL_EXPORTER_OTLP_ENDPOINT empty to
# disable tracing entirely — no overhead. Set it to an OTLP/HTTP collector
# (Tempo, Jaeger, Honeycomb, otel-collector, etc.) to start exporting traces.
OTEL_EXPORTER_OTLP_ENDPOINT=
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
OTEL_SERVICE_NAME=