.env.local.example

# App Configuration
SECRET_KEY='your-secret-key-here'
LITESTAR_DEBUG=true
LITESTAR_HOST=0.0.0.0
LITESTAR_PORT=8000
APP_URL=http://localhost:8000
LOG_LEVEL=20

# Database Configuration
DATABASE_ECHO=false
DATABASE_ECHO_POOL=false
DATABASE_POOL_DISABLED=false
DATABASE_POOL_MAX_OVERFLOW=10
DATABASE_POOL_SIZE=5
DATABASE_POOL_TIMEOUT=30
DATABASE_USER=app
DATABASE_PASSWORD=app
DATABASE_HOST=localhost
DATABASE_PORT=5432
DATABASE_DB=app
DATABASE_URL=postgresql://${DATABASE_USER}:${DATABASE_PASSWORD}@${DATABASE_HOST}:${DATABASE_PORT}/${DATABASE_DB}

# Worker Configuration
SAQ_USE_SERVER_LIFESPAN=false
SAQ_WEB_ENABLED=true
SAQ_PROCESSES=1
SAQ_CONCURRENCY=10

# Frontend Configuration
VITE_DEV_MODE=true
VITE_PORT=3006
ALLOWED_CORS_ORIGINS=["localhost:3006","localhost:8080","localhost:8000"]

# Proxy Configuration (for production behind reverse proxy)
# Trust X-Forwarded-* headers for correct HTTPS detection in OAuth redirects
# Use "*" to trust all proxies (safe for Railway/Docker), or specific IPs
# LITESTAR_TRUSTED_PROXIES=*

# Email Configuration (SMTP)
EMAIL_ENABLED=true  # Set to true to enable email sending
EMAIL_SMTP_HOST=localhost  # For Mailpit: localhost, for production: your SMTP host
EMAIL_SMTP_PORT=11025  # For Mailpit: 11025, for production: 587 (TLS) or 465 (SSL)
EMAIL_SMTP_USER=  # Mailpit doesn't require auth, leave empty for dev
EMAIL_SMTP_PASSWORD=  # Mailpit doesn't require auth, leave empty for dev
EMAIL_USE_TLS=false  # Mailpit doesn't use TLS, set true for production
EMAIL_USE_SSL=false  # Mailpit doesn't use SSL, set true for production
EMAIL_FROM_ADDRESS=noreply@localhost  # Default from email
EMAIL_FROM_NAME="Litestar Dev App"  # Default from name
EMAIL_TIMEOUT=30  # SMTP connection timeout in seconds

# OAuth Configuration (Google)
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_REDIRECT_URI=http://localhost:8000/auth/google/callback

# Production Google OAuth
# GOOGLE_CLIENT_ID=your-production-google-client-id
# GOOGLE_CLIENT_SECRET=your-production-google-client-secret
# GOOGLE_REDIRECT_URI=https://yourdomain.com/auth/google/callback

# Storage Configuration (RustFS - S3 Compatible)
# ===============================================
# RustFS provides S3-compatible object storage for file uploads
# Access RustFS console at: http://localhost:19001
# S3 API endpoint: http://localhost:19000
# Default credentials: app/app
#
# STORAGE_BACKEND=s3
# AWS_ACCESS_KEY_ID=app
# AWS_SECRET_ACCESS_KEY=app
# AWS_ENDPOINT_URL=http://localhost:19000
# STORAGE_BUCKET=uploads

# Mailpit (Development Email Testing)
# ====================================
# Access Mailpit web UI at: http://localhost:18025
# Mailpit SMTP server runs on: localhost:11025
# Mailpit catches all emails sent during development (modern MailHog replacement)

# Example Production Email Provider Configurations:
# =================================================

# Gmail (requires app password):
# EMAIL_SMTP_HOST=smtp.gmail.com
# EMAIL_SMTP_PORT=587
# EMAIL_SMTP_USER=your-email@gmail.com
# EMAIL_SMTP_PASSWORD=your-app-password
# EMAIL_USE_TLS=true
# EMAIL_USE_SSL=false

# SendGrid:
# EMAIL_SMTP_HOST=smtp.sendgrid.net
# EMAIL_SMTP_PORT=587
# EMAIL_SMTP_USER=apikey
# EMAIL_SMTP_PASSWORD=your-sendgrid-api-key
# EMAIL_USE_TLS=true

# AWS SES:
# EMAIL_SMTP_HOST=email-smtp.us-east-1.amazonaws.com
# EMAIL_SMTP_PORT=587
# EMAIL_SMTP_USER=your-ses-smtp-username
# EMAIL_SMTP_PASSWORD=your-ses-smtp-password
# EMAIL_USE_TLS=true

# Mailgun:
# EMAIL_SMTP_HOST=smtp.mailgun.org
# EMAIL_SMTP_PORT=587
# EMAIL_SMTP_USER=postmaster@yourdomain.mailgun.org
# EMAIL_SMTP_PASSWORD=your-mailgun-password
# EMAIL_USE_TLS=true