Installation

Get Huntarr running on Docker, Unraid, or from source.

Requirements

Docker and Docker Compose (recommended)
OR Python 3.10+ for source installs
512MB RAM minimum, 1GB recommended
Network access to your *arr instances

Docker (Recommended)

Create a docker-compose.yml file with the following:

services:
  huntarr:
    image: huntarr/huntarr:latest
    container_name: huntarr
    ports:
      - "9705:9705"
    volumes:
      - /path/to/huntarr/config:/config
      - /path/to/media:/media
    environment:
      - TZ=America/New_York
    restart: unless-stopped

Replace /path/to/huntarr/config and /path/to/media with your actual paths, then run:

docker-compose up -d

Unraid

Huntarr is available in Community Applications
Search for "Huntarr" in the CA store
Key settings: port 9705, /config mapping, timezone
The template auto-fills most settings — adjust paths as needed for your setup

From Source

git clone https://github.com/plexguide/Huntarr.io.git
cd Huntarr.io
pip install -r requirements.txt
python main.py

Access Huntarr at http://localhost:9705

Post-Installation

Open http://your-server:9705 in your browser. You'll be greeted by the Setup Wizard to configure your instance. See Setup Wizard for details.

Environment Variables

Variable	Default	Description
`TZ`	UTC	Timezone
`HUNTARR_PORT`	9705	Web UI port
`HUNTARR_LOG_LEVEL`	INFO	Log verbosity

Common Issues

Port conflict

If port 9705 is already in use, change the port mapping in your docker-compose.yml or use a different host port (e.g. 9706:9705).

Permission errors

Ensure the /config volume is writable by the container. Check ownership and permissions on the host path.

Can't reach *arr apps

Verify network connectivity between Huntarr and your Sonarr, Radarr, and other *arr instances. When using Docker, ensure they're on the same network or use host networking if needed.