.env.example

# BanManager WebUI - Environment Configuration
# Copy this file to .env and update values as needed.
#
# You usually don't need to fill this in by hand:
#   - Docker:  the entrypoint generates missing keys automatically.
#   - CLI:     run `npx bmwebui setup` for an interactive wizard.
#   - Web:     start the server with no keys and finish setup at http://your-host:3000/setup
#
# To verify your configuration at any time:
#   npx bmwebui doctor

# Server display name (shown in footer)
SERVER_FOOTER_NAME=BanManagement

# Contact email for push notification registration
CONTACT_EMAIL=youremail@example.com

# Database connection (defaults match docker-compose.yml)
DB_HOST=127.0.0.1
DB_PORT=3306
DB_USER=root
DB_PASSWORD=password
DB_NAME=bm_local_dev
DB_CONNECTION_LIMIT=5

# Security keys
# Leave blank to have setup (CLI/Docker/web installer) generate fresh values for you.
# To generate manually: node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
# These MUST be unique 64-character hex strings in production.
ENCRYPTION_KEY=
SESSION_KEY=

# Push notification VAPID keys
# Leave blank to have setup generate them, or run: npx web-push generate-vapid-keys
NOTIFICATION_VAPID_PUBLIC_KEY=
NOTIFICATION_VAPID_PRIVATE_KEY=

# Admin user credentials (used by seed script and Cypress tests)
ADMIN_USERNAME=admin@banmanagement.com
ADMIN_PASSWORD=testing

# Server configuration
PORT=3000
LOG_LEVEL=info

# Set to 'production' for production builds
NODE_ENV=development

# File upload configuration
# Maximum upload size (supports human-readable formats: 5MB, 10MB, 1GB, etc.)
UPLOAD_MAX_SIZE=10MB

# Path where uploaded documents are stored
UPLOAD_PATH=./uploads/documents

# Maximum image dimension (width or height) in pixels to prevent pixel bombs
UPLOAD_MAX_DIMENSION=8192

# How long before unattached documents are considered orphaned (in hours)
DOCUMENT_CLEANUP_AGE_HOURS=24