.env.example

# Forge Environment Variables
#
# This file provides a template for the environment variables needed to run the Forge application.
# Copy this file to .env and fill in the appropriate values for your development environment.
# Do not commit the .env file to your version control system.

# -----------------------------------------------------------------------------
# DATABASE SETTINGS
# -----------------------------------------------------------------------------
# PostgreSQL connection string.
# Example for local development with Docker: postgresql://forge:forge@localhost:5432/forge
DATABASE_URL=postgresql://user:password@host:port/dbname

# -----------------------------------------------------------------------------
# REDIS CACHE SETTINGS (Optional)
# -----------------------------------------------------------------------------
# URL for your Redis instance. If not provided, an in-memory cache will be used.
# REDIS_URL=redis://localhost:6379/0
# Prefix for all Redis keys to avoid collisions.
REDIS_PREFIX=forge

# -----------------------------------------------------------------------------
# SECURITY & AUTHENTICATION
# -----------------------------------------------------------------------------
# Secret key for signing JWTs. Generate a strong, random key.
# Use `openssl rand -hex 32` to generate a key.
SECRET_KEY=
# Secret key for encrypting sensitive data like provider API keys.
# Generate with: python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
ENCRYPTION_KEY=
# Algorithm for JWT signing.
ALGORITHM=HS256
# Access token expiration time in minutes.
ACCESS_TOKEN_EXPIRE_MINUTES=60

# -----------------------------------------------------------------------------
# CLERK AUTHENTICATION INTEGRATION (OPTIONAL)
# -----------------------------------------------------------------------------
# Your Clerk JWT public key (remove -----BEGIN PUBLIC KEY----- and -----END PUBLIC KEY----- headers/footers and newlines).
CLERK_JWT_PUBLIC_KEY=
# Your Clerk API key.
CLERK_API_KEY=
# Your Clerk API URL.
CLERK_API_URL=https://api.clerk.com/v1
# Your Clerk webhook signing secret.
CLERK_WEBHOOK_SECRET=

# -----------------------------------------------------------------------------
# APPLICATION & DEVELOPMENT SETTINGS
# -----------------------------------------------------------------------------
# Set to "production" or "development".
ENVIRONMENT=development
# Set to "true" to enable debug-level logging.
FORGE_DEBUG_LOGGING=false
# Host for the application.
HOST=0.0.0.0
# Port for the.
PORT=8000
# Set to "true" to enable auto-reloading for development.
RELOAD=false
# Number of Gunicorn worker processes.
WORKERS=4
# Set to "true" to force the use of in-memory cache, even if REDIS_URL is set.
# Useful for testing environments.
FORCE_MEMORY_CACHE=false
# Set to "true" to enable verbose cache debugging output.
DEBUG_CACHE=false
# Your application's domain, used for JWT audience validation.
APP_DOMAIN=localhost