Rustelo/book/appendices/env-variables.md

Environment Variables Reference

This document lists all environment variables used by Rustelo.

Core Variables

Variable	Description	Default	Required
SERVER_HOST	Server bind address	127.0.0.1	No
SERVER_PORT	Server port	3030	No
SERVER_PROTOCOL	Protocol (http/https)	http	No
ENVIRONMENT	Environment (DEV/PROD)	DEV	No
LOG_LEVEL	Log level	info	No

Database Variables (auth, content-db features)

Variable	Description	Default	Required
DATABASE_URL	Database connection URL	-	Yes
DATABASE_MAX_CONNECTIONS	Maximum connections	10	No
DATABASE_MIN_CONNECTIONS	Minimum connections	1	No

Authentication Variables (auth feature)

Variable	Description	Default	Required
JWT_SECRET	JWT signing secret	-	Yes
JWT_EXPIRATION_HOURS	JWT expiration	24	No
GOOGLE_CLIENT_ID	Google OAuth client ID	-	No
GOOGLE_CLIENT_SECRET	Google OAuth secret	-	No
GITHUB_CLIENT_ID	GitHub OAuth client ID	-	No
GITHUB_CLIENT_SECRET	GitHub OAuth secret	-	No

TLS Variables (tls feature)

Variable	Description	Default	Required
TLS_CERT_PATH	TLS certificate path	-	Yes
TLS_KEY_PATH	TLS private key path	-	Yes

Email Variables (email feature)

Variable	Description	Default	Required
EMAIL_PROVIDER	Email provider	console	No
EMAIL_FROM_ADDRESS	Default from address	-	Yes
EMAIL_FROM_NAME	Default from name	-	No
SMTP_HOST	SMTP server host	-	Conditional
SMTP_PORT	SMTP server port	587	Conditional
SMTP_USERNAME	SMTP username	-	Conditional
SMTP_PASSWORD	SMTP password	-	Conditional