.env.example

# ═══════════════════════════════════════════════════════════════════
# aMuTorrent - Environment Variables (OPTIONAL)
# ═══════════════════════════════════════════════════════════════════
#
# All environment variables are OPTIONAL. The recommended way to configure
# this application is through the interactive setup wizard on first run.
#
# Environment variables can be used to:
# 1. Pre-populate the setup wizard with default values
# 2. Skip the wizard entirely for automated deployments
# 3. Provide quick initial configuration
#
# Configuration Priority:
# - Sensitive fields (passwords, API keys): Environment variables ALWAYS override config.json
# - Non-sensitive fields: config.json > Environment variables > Defaults
#
# ═══════════════════════════════════════════════════════════════════

# Server Configuration
NODE_ENV=production
PORT=4000
# Bind address - which network interface to listen on
# Use 0.0.0.0 for all interfaces, 127.0.0.1 for localhost only
# BIND_ADDRESS=0.0.0.0

# Web UI Authentication (Optional)
# Enable password protection for the web interface
# WEB_AUTH_ENABLED=true
# WEB_AUTH_PASSWORD=your_secure_password

# Trusted Proxy SSO (Optional)
# Enable authentication via reverse proxy headers (e.g., Authelia, Authentik)
# Requires WEB_AUTH_ENABLED=true
# TRUSTED_PROXY_ENABLED=true
# TRUSTED_PROXY_USERNAME_HEADER=X-Remote-User
# TRUSTED_PROXY_AUTO_PROVISION=true

# aMule EC Configuration (OPTIONAL - wizard will prompt if not set)
# At least one download client (aMule, rTorrent, or qBittorrent) must be enabled
# Use 'amule' if using docker-compose.all-in-one.yml with included aMule container
# Use 'host.docker.internal' to connect to aMule on your host machine (standalone mode)
# Use IP address or hostname for remote aMule instances
# AMULE_ENABLED=true
# AMULE_HOST=host.docker.internal
# AMULE_PORT=4712
# AMULE_PASSWORD=your_password
# AMULE_SHARED_FILES_RELOAD_INTERVAL_HOURS=3
# AMULE_SHARED_DIR_DAT=/home/amule/.aMule/shareddir.dat

# rTorrent Configuration (Optional)
# Connect to rTorrent for BitTorrent downloads via XML-RPC or SCGI
# At least one download client (aMule, rTorrent, or qBittorrent) must be enabled
# RTORRENT_ENABLED=false
# RTORRENT_MODE=http          # Connection mode: http (XML-RPC proxy), scgi (direct TCP), scgi-socket (Unix socket)
# RTORRENT_HOST=localhost      # Host (for http and scgi modes)
# RTORRENT_PORT=8000           # Port (for http and scgi modes)
# RTORRENT_PATH=/RPC2          # XML-RPC path (http mode only)
# RTORRENT_SOCKET_PATH=        # Unix socket path (scgi-socket mode only, e.g., /path/to/rtorrent.sock)
# RTORRENT_USERNAME=           # HTTP basic auth username (http mode only)
# RTORRENT_PASSWORD=           # HTTP basic auth password (http mode only)
# RTORRENT_USE_SSL=false       # Use HTTPS (http mode only)

# qBittorrent Configuration (Optional)
# Connect to qBittorrent for BitTorrent downloads via WebUI API
# At least one download client (aMule, rTorrent, qBittorrent, or Deluge) must be enabled
# QBITTORRENT_ENABLED=false
# QBITTORRENT_HOST=localhost
# QBITTORRENT_PORT=8080
# QBITTORRENT_PATH=              # URL path for reverse proxy (e.g., /qbittorrent)
# QBITTORRENT_USERNAME=admin
# QBITTORRENT_PASSWORD=
# QBITTORRENT_USE_SSL=false

# Deluge Configuration (Optional)
# Connect to Deluge for BitTorrent downloads via WebUI JSON-RPC
# At least one download client (aMule, rTorrent, qBittorrent, Deluge, or Transmission) must be enabled
# DELUGE_ENABLED=false
# DELUGE_HOST=localhost
# DELUGE_PORT=8112
# DELUGE_PATH=                   # URL path for reverse proxy (e.g., /deluge)
# DELUGE_PASSWORD=deluge
# DELUGE_USE_SSL=false

# Transmission Configuration (Optional)
# Connect to Transmission for BitTorrent downloads via HTTP RPC
# At least one download client (aMule, rTorrent, qBittorrent, Deluge, or Transmission) must be enabled
# TRANSMISSION_ENABLED=false
# TRANSMISSION_HOST=localhost
# TRANSMISSION_PORT=9091
# TRANSMISSION_USERNAME=
# TRANSMISSION_PASSWORD=
# TRANSMISSION_USE_SSL=false
# TRANSMISSION_PATH=/transmission/rpc

# Sonarr Integration (Optional)
# Automatically trigger Sonarr to search for missing episodes at regular intervals
# SONARR_URL=http://localhost:8989
# SONARR_API_KEY=your_sonarr_api_key_here
# SONARR_SEARCH_INTERVAL_HOURS=6

# Radarr Integration (Optional)
# Automatically trigger Radarr to search for missing movies at regular intervals
# RADARR_URL=http://localhost:7878
# RADARR_API_KEY=your_radarr_api_key_here
# RADARR_SEARCH_INTERVAL_HOURS=6

# Prowlarr Integration (Optional)
# Search for torrents across indexers via Prowlarr (requires rTorrent or qBittorrent to be enabled)
# PROWLARR_URL=http://localhost:9696
# PROWLARR_API_KEY=your_prowlarr_api_key_here

# ED2K Rate Limiting
# Delay (in milliseconds) between searches to avoid ED2K server flood protection
# Default: 5000ms (5 seconds). Increase if you experience connection issues.
# ED2K_SEARCH_DELAY_MS=10000

# ED2K Search Cache
# Cache search results to handle Sonarr pagination (offset/limit) without duplicate searches
# Default: 600000ms (10 minutes). Results are cached per query to avoid re-searching ED2K.
# ED2K_CACHE_TTL_MS=600000

# ═══════════════════════════════════════════════════════════════════
# Multi-Instance Configuration
# ═══════════════════════════════════════════════════════════════════
#
# Environment variables configure the first instance of each client type.
# Additional instances can be added through the web UI Settings page.
#
# Env-imported clients are marked with source: 'env' in config.json.
# Sensitive fields (passwords) from env always override config.json values.
#

# Skip Setup Wizard (Optional)
# Set to true to skip the setup wizard entirely
# SKIP_SETUP_WIZARD=true

# Demo Mode (Optional)
# Set to true to generate fake data instead of fetching from real clients
# Useful for taking screenshots and showcasing the app
# DEMO_MODE=true