Setup Wizard

Huntarr's setup wizard guides you through initial configuration on first launch.

Overview

When you first access Huntarr at http://your-server:9705, the setup wizard appears. It walks you through:

1. Create an admin account

   Choose username and password, receive a recovery key.

2. Configure authentication settings

   2FA, Plex SSO, session timeout.

3. Connect your first *arr app

   Select app type, enter URL and API key.

4. Set up basic preferences

   Timezone, theme, port.

Step 1: Create Admin Account

• Choose a username and strong password
• A recovery key is generated — SAVE IT SECURELY
• This key is the only way to recover access if you forget your password
• Tip: Screenshot or copy it to a password manager immediately

Step 2: Authentication Settings

• Enable or disable Two-Factor Authentication (2FA)
• If enabled, scan the QR code with an authenticator app (Google Authenticator, Authy, etc.)
• Optional: Link your Plex account for Plex SSO login
• Configure session timeout (default: 24 hours)

Step 3: Connect Your First App

• Select an app type (Sonarr, Radarr, etc.)
• Enter the URL (e.g., http://localhost:8989 for Sonarr)
• Enter your API key (found in your app's Settings > General)
• Test the connection before saving
• You can add more apps later from the Apps page

Step 4: Basic Preferences

• Set your timezone
• Choose a default theme
• Configure the web UI port if needed

After Setup

• You'll land on the Huntarr dashboard
• Visit Settings > Scheduling to set up hunt cycles
• Visit Settings > Notifications to get alerts
• Add more app instances from the Apps page

Re-running Setup

If you need to start over:

1. Stop the Huntarr container
2. Delete the database file from your /config directory
3. Restart Huntarr
4. The setup wizard will appear again