env.example

# DomMate Environment Configuration
# Copy this file to .env and modify the values according to your setup

# =================================================================
# DATABASE CONFIGURATION
# =================================================================

# SQLite database file path (for Docker containers, use /app/data for persistence)
DATABASE_PATH=/app/data/domains.db

# Database backup directory (ensure this is also in a persistent location)
BACKUP_DIR=/app/data/backups

# =================================================================
# SERVER CONFIGURATION
# =================================================================

# Backend API server port
SERVER_PORT=3001

# Frontend development server port
CLIENT_PORT=4322

# Server host binding (use 0.0.0.0 for Docker)
SERVER_HOST=localhost

# Environment mode: development, production, test
NODE_ENV=development

# =================================================================
# SECURITY CONFIGURATION
# =================================================================

# JWT secret key for token signing (generate a strong random string)
JWT_SECRET=your-super-secret-jwt-key-change-this-in-production

# Session secret for cookie signing (generate a strong random string)
SESSION_SECRET=your-super-secret-session-key-change-this-in-production

# Session timeout in milliseconds (24 hours = 86400000)
SESSION_TIMEOUT=86400000

# Maximum failed login attempts before CAPTCHA is required
MAX_LOGIN_ATTEMPTS=5

# Login attempt window in minutes
LOGIN_ATTEMPT_WINDOW=15

# Default admin password (change immediately after first login)
DEFAULT_ADMIN_PASSWORD=admin123

# =================================================================
# EMAIL CONFIGURATION (SMTP)
# =================================================================

# Enable email notifications (true/false)
EMAIL_ENABLED=false

# SMTP hostname
SMTP_HOST=smtp.gmail.com

# SMTP port (587 for TLS, 465 for SSL, 25 for unencrypted)
SMTP_PORT=587

# Enable TLS/STARTTLS (true/false)
SMTP_SECURE=false

# SMTP authentication username
SMTP_USER=your-email@gmail.com

# SMTP authentication password or app-specific password
SMTP_PASS=your-app-password

# Email sender name
EMAIL_FROM_NAME=DomMate Notification System

# Email sender address
EMAIL_FROM_ADDRESS=noreply@dommate.com

# Default email template language (en/zh)
EMAIL_DEFAULT_LANGUAGE=en

# =================================================================
# DOMAIN CHECKING CONFIGURATION
# =================================================================

# Domain check interval in hours (default: 24 hours)
DOMAIN_CHECK_INTERVAL=24

# WHOIS request timeout in milliseconds
WHOIS_TIMEOUT=10000

# Maximum concurrent domain checks
MAX_CONCURRENT_CHECKS=10

# Domain expiration warning days (comma-separated)
EXPIRATION_WARNING_DAYS=30,15,7,3,1

# =================================================================
# NOTIFICATION CONFIGURATION
# =================================================================

# Enable scheduled notifications (true/false)
NOTIFICATIONS_ENABLED=true

# Notification check interval in minutes
NOTIFICATION_CHECK_INTERVAL=60

# Maximum notifications per day per domain
MAX_NOTIFICATIONS_PER_DAY=5

# Email template directory
EMAIL_TEMPLATE_DIR=./server/templates

# =================================================================
# EXPORT CONFIGURATION
# =================================================================

# Maximum export records limit
MAX_EXPORT_RECORDS=10000

# Export file cleanup interval in hours
EXPORT_CLEANUP_INTERVAL=24

# Export temporary directory
EXPORT_TEMP_DIR=./temp/exports

# =================================================================
# LOGGING CONFIGURATION
# =================================================================

# Log level: error, warn, info, debug
LOG_LEVEL=info

# Log file path
LOG_FILE=./logs/dommate.log

# Enable console logging (true/false)
LOG_CONSOLE=true

# Log rotation: daily, weekly, monthly
LOG_ROTATION=daily

# Maximum log file size in MB
LOG_MAX_SIZE=10

# Maximum number of log files to keep
LOG_MAX_FILES=30

# =================================================================
# RATE LIMITING
# =================================================================

# API rate limit requests per window
RATE_LIMIT_REQUESTS=100

# API rate limit window in minutes
RATE_LIMIT_WINDOW=15

# Enable rate limiting (true/false)
RATE_LIMIT_ENABLED=true

# =================================================================
# CORS CONFIGURATION
# =================================================================

# Allowed origins for CORS (comma-separated URLs)
CORS_ORIGINS=http://localhost:4322,https://dommate.com

# Enable CORS credentials (true/false)
CORS_CREDENTIALS=true

# =================================================================
# BACKUP CONFIGURATION
# =================================================================

# Enable automatic database backups (true/false)  
BACKUP_ENABLED=true

# Backup interval in hours
BACKUP_INTERVAL=24

# Maximum number of backup files to keep
BACKUP_MAX_FILES=30

# Backup compression (true/false)
BACKUP_COMPRESSION=true

# =================================================================
# PERFORMANCE CONFIGURATION
# =================================================================

# Maximum request body size in MB
MAX_REQUEST_SIZE=10

# Request timeout in milliseconds
REQUEST_TIMEOUT=30000

# Enable gzip compression (true/false)
ENABLE_COMPRESSION=true

# =================================================================
# DEVELOPMENT CONFIGURATION
# =================================================================

# Enable debug mode (true/false)
DEBUG_MODE=false

# Enable API documentation endpoint (true/false)
ENABLE_API_DOCS=false

# Enable development middleware (true/false)
ENABLE_DEV_MIDDLEWARE=false

# =================================================================
# DOCKER CONFIGURATION
# =================================================================

# Docker container name prefix
DOCKER_CONTAINER_PREFIX=dommate

# Docker network name
DOCKER_NETWORK=dommate-network

# Data volume mount path inside container
DATA_VOLUME_PATH=/app/data

# =================================================================
# MONITORING CONFIGURATION
# =================================================================

# Enable health check endpoint (true/false)
ENABLE_HEALTH_CHECK=true

# Health check endpoint path
HEALTH_CHECK_PATH=/health

# Enable metrics collection (true/false)
ENABLE_METRICS=false

# Metrics endpoint path
METRICS_PATH=/metrics