Quick Setup

Get Seekarr running and connected to your first app in under five minutes.

Step 1 — Start Seekarr

If you haven't installed Seekarr yet, the fastest way is a single Docker command:

docker run -d --name seekarr \
  --restart always \
  -p 9705:9705 \
  -v /your-path/seekarr:/config \
  -e TZ=America/New_York \
  ghcr.io/diybits/seekarr:latest

See the Installation Guide for Docker Compose and Unraid instructions.

Step 2 — Open the Web UI

Navigate to http://YOUR_SERVER_IP:9705 in your browser. On first launch you will be prompted to create an admin account.

Choose a username and a strong password.
Optionally enable two-factor authentication (TOTP) — you can do this later from your profile.

Step 3 — Connect Your First App

Go to Settings and select the app you want to connect (Sonarr, Radarr, Lidarr, Readarr, or Whisparr).

For each app you need:

Field	Where to find it
API URL	The base URL of your app, e.g. `http://10.0.0.5:8989`. Omit the trailing slash.
API Key	In your app: Settings → General → Security → API Key

Click Test Connection to verify, then Save.

Step 4 — Configure Hunt Settings

Within each app's settings, configure how aggressively Seekarr searches:

Setting	Recommended starting value
Hunt Missing Items	`1` — search for 1 missing item per cycle
Hunt Upgrade Items	`1` — search for 1 quality upgrade per cycle
Sleep Duration	`900` seconds (15 minutes) between cycles
Monitored Only	Enabled — only process items marked as monitored

Start conservative and increase the values once you are happy with the load on your indexers.

Protecting curated content: Seekarr only touches items that are marked as monitored in their respective *Arr application. If you have hand-selected media you don't want auto-searched or upgraded, unmonitor those items in Sonarr, Radarr, etc. before enabling Seekarr — it will skip them entirely.

Step 5 — Watch It Work

Return to the Home page to see live hunt statistics, or go to Logs to watch Seekarr process items in real time. That's it — Seekarr will now run continuously in the background.

Next Steps

Full Configuration Reference →