polishing for prod testing.

.env.example

@@ -1,38 +1,87 @@
+# ===========================================
+# GallerySubscriber Environment Configuration
+# ===========================================
+# Copy this file to .env and configure the required values.
+
 # ===========================================
 # Required - You MUST change these values
 # ===========================================
 
 # Database password for PostgreSQL
+# Use a strong, unique password
 DB_PASSWORD=change_me_to_secure_password
 
-# Application secret key (use: openssl rand -hex 32)
+# Application secret key for encryption
+# Generate with: openssl rand -hex 32
 SECRET_KEY=change_me_to_random_string_at_least_32_characters
 
 # ===========================================
 # Optional - These have sensible defaults
 # ===========================================
 
-# External port to access the application
+# Timezone (used by app, celery, and database)
+# See: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+TZ=America/New_York
+
+# External port to access the web UI
 PORT=8080
 
 # Download settings
+# DOWNLOAD_PARALLEL_LIMIT: Max concurrent downloads
+# DOWNLOAD_RATE_LIMIT: Seconds between requests (to avoid rate limiting)
+# DEFAULT_CHECK_INTERVAL: Seconds between automatic checks for new content
 DOWNLOAD_PARALLEL_LIMIT=3
 DOWNLOAD_RATE_LIMIT=3.0
 DEFAULT_CHECK_INTERVAL=3600
 
-# Logging
+# Logging level (DEBUG, INFO, WARNING, ERROR)
 LOG_LEVEL=INFO
+
+# Debug mode (enables verbose output, not for production)
 DEBUG=false
 
+# ===========================================
+# Database Configuration
+# ===========================================
+# These compose the DATABASE_URL automatically.
+# Defaults work with the included PostgreSQL container.
+# Change these if using an external database.
+
+DB_USER=gdl
+DB_HOST=db
+DB_PORT=5432
+DB_NAME=gallery_subscriber
+
+# ===========================================
+# Redis Configuration
+# ===========================================
+# Defaults work with the included Redis container.
+# Change these if using an external Redis instance.
+
+REDIS_HOST=redis
+REDIS_PORT=6379
+
+# ===========================================
+# Data Storage Paths
+# ===========================================
+# Host paths for persistent data. By default, Docker named volumes are used.
+# Set these to use bind mounts instead (e.g., for NAS storage).
+#
+# Examples:
+#   DATA_DOWNLOADS=/mnt/nas/gallery-subscriber/downloads
+#   DATA_CONFIG=./data/config
+#
+# DATA_DOWNLOADS: Where downloaded files are stored
+# DATA_CONFIG: Gallery-dl config and download archive (for deduplication)
+
+# DATA_DOWNLOADS=downloads
+# DATA_CONFIG=config
+
 # ===========================================
 # Advanced - Only change if you know what you're doing
 # ===========================================
 
-# Paths inside container (mapped to Docker volumes)
-DOWNLOAD_PATH=/data/downloads
-CONFIG_PATH=/data/config
-COOKIES_PATH=/data/cookies
-
-# These are constructed by docker-compose, only set for local development
+# Full connection URLs (constructed automatically from components above)
+# Only set these directly for special configurations
 # DATABASE_URL=postgresql://gdl:password@localhost:5432/gallery_subscriber
 # REDIS_URL=redis://localhost:6379/0