# ============================================================================= # VEZA BACKEND API - ENVIRONMENT TEMPLATE # ============================================================================= # This is a template file. Copy to .env and fill in actual values. # DO NOT commit .env with real secrets to Git! # ============================================================================= # --- ENVIRONMENT --- # Options: development, staging, production APP_ENV=development APP_PORT=8080 LOG_LEVEL=info # --- DOMAIN (single source of truth) --- # All service URLs and CORS origins derive from this in development. # Change this + /etc/hosts to switch domain. APP_DOMAIN=veza.fr # --- DATABASE (REQUIRED) --- # PostgreSQL connection string (host ports when using docker-compose: 15432) # In Docker: postgres:5432 | On host: veza.fr:15432 DATABASE_URL=postgres://veza:password@veza.fr:15432/veza?sslmode=disable # Optional: Read replica for scaling read-heavy workloads (same format as DATABASE_URL) # DATABASE_READ_URL=postgres://veza:password@veza-read-replica:5432/veza?sslmode=disable DATABASE_MAX_OPEN_CONNS=25 DATABASE_MAX_IDLE_CONNS=5 DATABASE_CONN_MAX_LIFETIME=5m # --- JWT & AUTHENTICATION (v0.9.1 RS256) --- # PREFERRED: RS256 with RSA keys (generate with scripts/generate-jwt-keys.sh) # JWT_PRIVATE_KEY_PATH=/path/to/jwt-private.pem # JWT_PUBLIC_KEY_PATH=/path/to/jwt-public.pem # FALLBACK (dev only): JWT_SECRET must be at least 32 characters JWT_SECRET=dev-secret-key-minimum-32-characters-long-for-testing-only JWT_ISSUER=veza-api JWT_AUDIENCE=veza-platform JWT_ACCESS_TOKEN_DURATION=15m JWT_REFRESH_TOKEN_DURATION=30d # --- COOKIES --- # Set to true in production for HTTPS-only cookies COOKIE_SECURE=false COOKIE_SAME_SITE=lax COOKIE_DOMAIN= # --- CORS (REQUIRED) --- # Comma-separated list of allowed origins # Development: http://veza.fr:5173,http://veza.fr:3000 (or your APP_DOMAIN) # Production: https://app.veza.com,https://www.veza.com CORS_ALLOWED_ORIGINS=http://veza.fr:5173,http://veza.fr:3000 # --- REDIS (REQUIRED for CSRF, rate limiting, cache) --- # Redis (host port when using docker-compose: 16379) # In Docker: redis:6379 | On host: veza.fr:16379 REDIS_URL=redis://veza.fr:16379 REDIS_ADDR=veza.fr:6379 REDIS_PASSWORD= REDIS_DB=0 # --- RABBITMQ --- # Enable message queue for async events (use veza:password, host port 15672 for docker-compose) # In Docker: amqp://veza:password@rabbitmq:5672/ | On host: amqp://veza:password@veza.fr:15672/ RABBITMQ_ENABLE=true RABBITMQ_URL=amqp://veza:password@veza.fr:15672/ # --- SENTRY (OPTIONAL - Recommended for production) --- # Error tracking and monitoring SENTRY_DSN= SENTRY_ENVIRONMENT=development SENTRY_SAMPLE_RATE_ERRORS=1.0 SENTRY_SAMPLE_RATE_TRANSACTIONS=0.1 # --- RATE LIMITING --- RATE_LIMIT_ENABLED=true RATE_LIMIT_REQUESTS_PER_SECOND=100 # --- FILE UPLOADS --- UPLOAD_DIR=./uploads ENABLE_CLAMAV=false CLAMAV_REQUIRED=false # --- HYPERSWITCH (PAYMENTS - OPTIONAL) --- # Required for real payment processing. Leave empty to use simulated payments. HYPERSWITCH_ENABLED=false HYPERSWITCH_URL=http://veza.fr:18081 # From Hyperswitch Control Center (app.hyperswitch.io) > Settings > Developers HYPERSWITCH_API_KEY= # For webhook signature verification HYPERSWITCH_WEBHOOK_SECRET= # Checkout success redirect (used in return_url) CHECKOUT_SUCCESS_URL=http://veza.fr:5173/purchases # --- STRIPE CONNECT (SELLER PAYOUT - OPTIONAL) --- # Required for seller payout (balance, onboarding, transfers). # Get keys from Stripe Dashboard > Connect > Settings STRIPE_CONNECT_ENABLED=false # Secret key for server-side Stripe API calls (sk_test_xxx or sk_live_xxx) STRIPE_SECRET_KEY= # Webhook secret for Connect events (whsec_xxx) STRIPE_CONNECT_WEBHOOK_SECRET= # --- EXTERNAL SERVICES (OPTIONAL) --- STREAM_SERVER_URL=http://veza.fr:8082 # Must match stream server INTERNAL_API_KEY for /internal/jobs/transcode (P1.1.2) STREAM_SERVER_INTERNAL_API_KEY= CHAT_SERVER_URL=http://veza.fr:8081 # --- FRONTEND URL --- # Used for password reset links, email templates, etc. FRONTEND_URL=http://veza.fr:5173 # --- BASE URL --- # Public base URL of this backend (used for OAuth callbacks, etc.) BASE_URL=http://veza.fr:8080 # --- EMAIL (OPTIONAL) --- # Required if email verification / password reset enabled SMTP_HOST= SMTP_PORT=587 SMTP_USERNAME= SMTP_PASSWORD= SMTP_FROM=noreply@veza.com # --- MONITORING (OPTIONAL) --- PROMETHEUS_URL= # ============================================================================= # VALIDATION RULES # ============================================================================= # # REQUIRED (app will not start without these): # - DATABASE_URL # - JWT_SECRET (min 32 chars) # - REDIS_URL or REDIS_ADDR # - CORS_ALLOWED_ORIGINS (can be empty for strict mode) # # RECOMMENDED for production: # - SENTRY_DSN # - COOKIE_SECURE=true # - COOKIE_SAME_SITE=strict # # OPTIONAL: # - RABBITMQ_* (if async events not used) # - SMTP_* (if email not used) # - CLAMAV_* (if file scanning not used) # # =============================================================================