.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

# Reuse-port: run N processes on the same port (kernel load-balances).
# Alternative to cluster mode — do NOT enable both. Scale via PM2 instances.
APP_REUSE_PORT=false

# With docker compose, use service hostnames instead of localhost:
#   postgres / redis / clickhouse (e.g. @postgres:5432, REDIS_HOST=redis)
# NOTE: keep values UNQUOTED — `docker run --env-file` passes quotes literally.
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/elysia_db

# Used by docker-compose.yml to provision the postgres container.
# Keep these in sync with DATABASE_URL.
POSTGRES_DB=elysia_db
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres

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=*