Configuration

Web-Based Configuration (Recommended)

The easiest way to configure Dasharr is through the web interface:

Navigate to http://localhost:3000
Click Configuration in the navigation
Select a service to configure
Enter your service URL and API key/token
Click Test Connection to verify
Click Save Configuration

Environment Variables

For automated deployments, you can configure services using environment variables.

Create a .env file with your service details:

# Dasharr Runtime Configuration
# This file contains runtime configuration for the Dasharr container
# Copy this file to .env and configure with your values
# DO NOT commit the .env file to version control

# ========================================
# Application Settings
# ========================================
# All of these have hardcoded defaults if not set

# Port the application will run on (default: 3000)
# PORT=3000

# Host binding (default: 0.0.0.0 for all interfaces)
# HOST=0.0.0.0

# Timezone for the application (default: America/New_York)
# Find your timezone: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
# TZ=America/New_York

# Full URL where the application is accessible (default: http://localhost:3000)
# Used for generating absolute URLs
# APP_URL=http://localhost:3000

# Enable if running behind a reverse proxy (default: false)
# Set to true if using nginx, Caddy, Cloudflare, etc.
# TRUST_PROXY=true

# User and group IDs for file permissions in Docker (default: 1000)
# PUID=1000
# PGID=1000

# MaxMind license key for geolocation (optional)
# Get a free license key at: https://www.maxmind.com/en/geolite2/signup
# MAXMIND_LICENSE_KEY=

# ========================================
# Service API Keys and URLs
# ========================================
# Configure these through the web interface at /config
# or set them here directly

# Plex Configuration
# Find your token: https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/
# PLEX_URL=http://your-plex-server:32400
# PLEX_TOKEN=your-plex-token

# Tautulli Configuration
# API key found in Settings > Web Interface > API
# TAUTULLI_URL=http://your-tautulli:8181
# TAUTULLI_API_KEY=your-tautulli-api-key

# Overseerr Configuration
# API key found in Settings > Users > Your User > Edit > API Key
# OVERSEERR_URL=http://your-overseerr:5055
# OVERSEERR_API_KEY=your-overseerr-api-key

# Radarr Configuration
# API key found in Settings > General > Security
# RADARR_URL=http://your-radarr:7878
# RADARR_API_KEY=your-radarr-api-key

# Sonarr Configuration
# API key found in Settings > General > Security
# SONARR_URL=http://your-sonarr:8989
# SONARR_API_KEY=your-sonarr-api-key

# Prowlarr Configuration
# API key found in Settings > General > Security
# PROWLARR_URL=http://your-prowlarr:9696
# PROWLARR_API_KEY=your-prowlarr-api-key

# SABnzbd Configuration
# API key found in Config > General > Security
# Use the FULL API key, not the NZB key
# SABNZBD_URL=http://your-sabnzbd:8080
# SABNZBD_API_KEY=your-sabnzbd-api-key

# qBittorrent Configuration
# Enable Web UI in Options > Web UI
# QBITTORRENT_URL=http://your-qbittorrent:8080
# QBITTORRENT_USERNAME=admin
# QBITTORRENT_PASSWORD=your-password

# ========================================
# Security Settings
# ========================================
# IMPORTANT: Generate a secure random string for session encryption
# You can generate one using: openssl rand -base64 32
# SESSION_SECRET=change-this-to-a-random-string

# ========================================
# Logging
# ========================================
# Log level: error, warn, info, debug (default: info)
# LOG_LEVEL=info