Configuration

Environment variables and configuration options.

Environment Variables

These environment variables are required. Missing values will cause startup failures.
VariableDescriptionExample
SECRET_KEYJWT signing keyyour-super-secret-key
DATABASE_URLPostgreSQL connectionpostgresql://user:pass@localhost/db
REDIS_URLRedis connectionredis://localhost:6379

Optional Variables

VariableDefaultDescription
DEBUGFalseEnable debug mode
CORS_ORIGINS["*"]Allowed CORS origins
ACCESS_TOKEN_EXPIRE_MINUTES30Access token lifetime
REFRESH_TOKEN_EXPIRE_DAYS7Refresh token lifetime

.env File

.env.example
# Core Settings
SECRET_KEY=your-super-secret-key-change-this
DEBUG=False

# Database
DATABASE_URL=postgresql://user:password@localhost:5432/forgeapi

# Redis
REDIS_URL=redis://localhost:6379

# OAuth (Optional)
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

# Email (Optional)
SENDGRID_API_KEY=
Copy .env.example to .env and fill in your values.