.env.example

################################################################################
# STRAPI V5 ENVIRONMENT CONFIGURATION
################################################################################
# IMPORTANT: This is a template file. Copy to .env and fill with actual values.
# NEVER commit .env files to version control!
#
# Quick Setup:
#   1. Copy this file: cp .env.example .env
#   2. Generate secrets: ./scripts/generate-secrets.sh
#   3. Update database credentials
#   4. Set your domain/subdomain
#
# For specific environments, see:
#   - .env.local.example (local development)
#   - .env.production.example (production deployment)
################################################################################

################################################################################
# APPLICATION ENVIRONMENT
################################################################################

# Application environment: development | staging | production
# - development: Debug mode, detailed errors, auto-reload
# - production: Optimized, minimal logging, no auto-reload
NODE_ENV=production

# Server host binding (0.0.0.0 allows external connections)
HOST=0.0.0.0

# Server port (default: 1337)
PORT=1337

################################################################################
# PUBLIC URL & DOMAIN CONFIGURATION
################################################################################

# Full public URL where Strapi will be accessible
# For Cloudflare subdomain: https://api.yourdomain.com
# Used for: CORS, webhooks, email links, media URLs
PUBLIC_URL=https://api.yourdomain.com

# Alternative: Use subdomain
# SUBDOMAIN=api
# DOMAIN=yourdomain.com
# PUBLIC_URL=https://${SUBDOMAIN}.${DOMAIN}

# Admin panel custom path (default: /admin)
# Change this for additional security through obscurity
ADMIN_PATH=/admin

################################################################################
# DATABASE CONFIGURATION
################################################################################

# Database client: postgres | mysql | better-sqlite3
# Recommended: postgres for production, better-sqlite3 for Cloudflare D1
DATABASE_CLIENT=postgres

# PostgreSQL Configuration
DATABASE_HOST=postgres
DATABASE_PORT=5432
DATABASE_NAME=strapi
DATABASE_USERNAME=strapi
DATABASE_PASSWORD=CHANGE_THIS_SECURE_PASSWORD_IN_PRODUCTION

# SSL/TLS for database connections
# Set to true for managed databases (RDS, Cloud SQL, Neon, etc.)
DATABASE_SSL=false

# Connection pool settings (optional, for production)
# DATABASE_POOL_MIN=2
# DATABASE_POOL_MAX=10

# For Cloudflare D1 or local SQLite:
# DATABASE_CLIENT=better-sqlite3
# DATABASE_FILENAME=.tmp/data.db

################################################################################
# SECURITY SECRETS
################################################################################
# CRITICAL: Generate unique, random values for production!
# Use: ./scripts/generate-secrets.sh
# Or manually: openssl rand -base64 32
################################################################################

# JWT secret for API authentication tokens
# Min length: 32 characters
JWT_SECRET=GENERATE_RANDOM_32_CHAR_SECRET_HERE

# Admin panel JWT secret
# Min length: 32 characters
ADMIN_JWT_SECRET=GENERATE_RANDOM_32_CHAR_SECRET_HERE

# Salt for API tokens
# Min length: 32 characters
API_TOKEN_SALT=GENERATE_RANDOM_32_CHAR_SECRET_HERE

# Salt for transfer tokens
# Min length: 32 characters
TRANSFER_TOKEN_SALT=GENERATE_RANDOM_32_CHAR_SECRET_HERE

# App keys for session cookies (comma-separated, minimum 4 keys)
# Generate 4 separate secrets and comma-separate them
# Format: key1,key2,key3,key4
APP_KEYS=GENERATE_KEY1,GENERATE_KEY2,GENERATE_KEY3,GENERATE_KEY4

################################################################################
# CLOUDFLARE CONFIGURATION
################################################################################

# Cloudflare Account ID
# Find at: https://dash.cloudflare.com/
CF_ACCOUNT_ID=your_cloudflare_account_id

# Cloudflare Zone ID (for your domain)
# Find in domain overview: https://dash.cloudflare.com/
CF_ZONE_ID=your_cloudflare_zone_id

# Cloudflare API Token (for DNS/Workers management)
# Create at: https://dash.cloudflare.com/profile/api-tokens
# Required permissions: Workers, DNS
CF_API_TOKEN=your_cloudflare_api_token

# Cloudflare R2 Configuration (for file uploads)
# R2_ACCOUNT_ID=your_account_id
# R2_ACCESS_KEY_ID=your_access_key
# R2_SECRET_ACCESS_KEY=your_secret_key
# R2_BUCKET_NAME=strapi-uploads
# R2_PUBLIC_URL=https://uploads.yourdomain.com

# Cloudflare KV Namespace (for caching)
# KV_NAMESPACE_ID=your_kv_namespace_id

################################################################################
# CORS & SECURITY
################################################################################

# Allowed origins for CORS (comma-separated)
# Include your frontend domains and subdomains
# Example: https://yourdomain.com,https://www.yourdomain.com,https://app.yourdomain.com
CORS_ORIGINS=https://yourdomain.com,https://www.yourdomain.com

# Alternatively, allow all origins (NOT recommended for production)
# CORS_ORIGINS=*

################################################################################
# RATE LIMITING
################################################################################

# Enable rate limiting (recommended for production)
RATE_LIMIT_ENABLED=true

# Max requests per time window
RATE_LIMIT_MAX_REQUESTS=100

# Time window in milliseconds (default: 60000 = 1 minute)
RATE_LIMIT_DURATION=60000

################################################################################
# FILE UPLOADS & STORAGE
################################################################################

# Maximum file upload size in bytes (default: 200MB)
# Cloudflare free tier limit: 100MB
MAX_FILE_SIZE=104857600

# Upload provider: local | cloudflare-r2 | aws-s3 | cloudinary
UPLOAD_PROVIDER=local

# For local development/testing (not recommended for production)
# UPLOAD_PATH=./public/uploads

################################################################################
# EMAIL CONFIGURATION
################################################################################

# Email provider: sendmail | nodemailer | sendgrid | mailgun | amazon-ses
# EMAIL_PROVIDER=sendgrid

# SMTP Configuration (if using nodemailer)
# EMAIL_SMTP_HOST=smtp.example.com
# EMAIL_SMTP_PORT=587
# EMAIL_SMTP_USERNAME=your_username
# EMAIL_SMTP_PASSWORD=your_password
# EMAIL_FROM=noreply@yourdomain.com
# EMAIL_REPLY_TO=support@yourdomain.com

# SendGrid
# SENDGRID_API_KEY=your_sendgrid_api_key

# Mailgun
# MAILGUN_API_KEY=your_mailgun_api_key
# MAILGUN_DOMAIN=mg.yourdomain.com

################################################################################
# LOGGING & MONITORING
################################################################################

# Log level: fatal | error | warn | info | debug | trace
LOG_LEVEL=info

# Enable query logging (useful for debugging, disable in production)
LOG_QUERIES=false

# Sentry DSN for error tracking
# SENTRY_DSN=https://xxx@xxx.ingest.sentry.io/xxx

################################################################################
# CACHING
################################################################################

# Cache provider: memory | redis
# CACHE_PROVIDER=memory

# Redis Configuration (if using Redis)
# REDIS_HOST=localhost
# REDIS_PORT=6379
# REDIS_PASSWORD=
# REDIS_DB=0

################################################################################
# WEBHOOKS & INTEGRATIONS
################################################################################

# Webhook signing secret (for verifying incoming webhooks)
# WEBHOOK_SECRET=GENERATE_RANDOM_SECRET

# External service API keys
# STRIPE_API_KEY=
# PAYPAL_CLIENT_ID=
# GOOGLE_MAPS_API_KEY=

################################################################################
# DEVELOPMENT & DEBUGGING
################################################################################

# Enable GraphQL Playground (disable in production)
# GRAPHQL_PLAYGROUND=false

# Enable API documentation (disable in production)
# API_DOCS_ENABLED=false

# Debug mode
# DEBUG=false

################################################################################
# PERFORMANCE
################################################################################

# Enable compression
COMPRESSION_ENABLED=true

# Response cache time in seconds
# RESPONSE_CACHE_TIME=3600

################################################################################
# BACKUP & MAINTENANCE
################################################################################

# Backup schedule (cron format)
# BACKUP_SCHEDULE=0 2 * * *

# Backup retention days
# BACKUP_RETENTION_DAYS=30

################################################################################
# FEATURE FLAGS
################################################################################

# Enable/disable specific features
# FEATURE_REGISTRATION_ENABLED=true
# FEATURE_FORGOT_PASSWORD_ENABLED=true
# FEATURE_EMAIL_CONFIRMATION_ENABLED=true

################################################################################
# NOTES
################################################################################
# - Strings with special characters should be wrapped in quotes
# - Boolean values: true or false (lowercase, no quotes)
# - Numbers: no quotes
# - Arrays/Objects: Use JSON format if needed
# - Never use spaces around = sign
# - Comments start with #
# - Empty values can be left blank or commented out
################################################################################