.env.example

# =============================================================================
# Huntarr2 environment variables
# =============================================================================
#
# This file is a reference for docker-compose users. Copy it to .env and
# edit as needed. Docker Compose loads .env automatically.
#
# If you are running Huntarr2 through Unraid, Portainer, Synology, TrueNAS,
# or any other Docker platform, set these variables through that platform's
# own UI instead. The Dockerfile already provides sensible defaults for all
# values below, so you only need to override what you want to change.

# =============================================================================
# Server port (default: 9706)
# =============================================================================

# PORT=9706


# =============================================================================
# Log level (default: info)
# =============================================================================

# Valid values are: debug, info, warn, error
# LOG_LEVEL=info


# =============================================================================
# Database path (default: /config/huntarr2.db)
# =============================================================================

# Path to the SQLite database file inside the container. The default stores
# it in the /config volume so it persists across container recreations.

# DATABASE_PATH=/config/huntarr2.db


# =============================================================================
# Encryption key for API keys at rest
# =============================================================================

# A 32-byte key used to encrypt *arr API keys in the database. Provide it as
# a 64-character hex string or a base64-encoded 32-byte value.
#
# If left empty, the entrypoint script automatically generates a hex key and
# persists it to /config/encryption.key inside the container. The generated
# key is reused on subsequent starts, so encrypted data remains readable
# across container recreations as long as the /config volume is preserved.
#
# To generate your own key manually:
#   openssl rand -hex 32
#
# WARNING: Changing or losing this key after initial setup will make existing
# encrypted API keys unreadable. Back up your key securely.

# ENCRYPTION_KEY=


# =============================================================================
# User / group identity (default: 1000:1000)
# =============================================================================

# PUID and PGID control the UID/GID that Huntarr2 runs as inside the
# container. Set these to match your host user so that files written to
# /config have the correct ownership.
#
# On Unraid the conventional values are PUID=99 PGID=100 (nobody:users).

# PUID=1000
# PGID=1000


# =============================================================================
# Timezone (default: UTC)
# =============================================================================

# TZ=UTC


# =============================================================================
# Basic authentication (optional)
# =============================================================================

# Set both AUTH_USERNAME and AUTH_PASSWORD to enable HTTP Basic Authentication
# on all routes except the health check endpoint (/api/health). Leave both
# empty to disable authentication entirely.

# AUTH_USERNAME=
# AUTH_PASSWORD=