.env.example

NODE_ENV="development"

APP_NAME="Elysia APP"
APP_PORT=3000
APP_URL="http://localhost:3000"
APP_TIMEZONE="UTC"
APP_KEY="your-app-key"

# REQUIRED, no default. This is the only secret that signs JWTs
# (src/libs/config/jwt.config.ts -> AuthPlugin). The process refuses to boot
# without it. Generate one: openssl rand -base64 48
JWT_SECRET="change-me-before-running"

# API docs (Scalar UI at /docs). The only switch, independent of NODE_ENV.
# Defaults to false when unset, so an environment that forgets it stays closed.
# On for local development; leave it off or unset everywhere else.
ENABLE_API_DOCS=true

APP_CLUSTER_MODE=false
APP_CLUSTER_WORKERS=0

# SO_REUSEPORT: N independent processes share APP_PORT and the kernel
# load-balances. Alternative to APP_CLUSTER_MODE — never enable both.
APP_REUSE_PORT=false

# PM2_INSTANCES is read by ecosystem.config.cjs, not by the app, so it is not
# validated in src/libs/config/env.config.ts and does not belong in .env.
# Pass it inline instead:
#   PM2_INSTANCES=4 pm2 start ecosystem.config.cjs --env production

DATABASE_URL="postgresql://postgres:postgres@localhost:5432/elysia_db"

CLICKHOUSE_HOST="http://localhost:8123"
CLICKHOUSE_USER="app"
CLICKHOUSE_PASSWORD="secret"
CLICKHOUSE_DATABASE="app"

CLIENT_URL="http://localhost:3000"

REDIS_HOST="localhost"
REDIS_PORT=6379
REDIS_PASSWORD=password123
REDIS_DB=0

# envalid treats `VAR=` as a provided empty string, not as absent, so an empty
# value here defeats the default declared in env.config.ts and fails validation
# at boot. Every MAIL_* line carries a real placeholder for that reason.
MAIL_HOST="smtp.example.com"
MAIL_PORT=587
MAIL_SECURE="false"
MAIL_USER="your_email@example.com"
MAIL_PASS="your_email_password"
MAIL_FROM="Elysia <your_email@example.com>"

LOG_LEVEL="info"

ALLOWED_HOST="*"