Skip to content

Configuration

Jump to bottom
Doezer edited this page May 16, 2026 · 2 revisions

Configuration Guide

Initial Setup

On first launch Questarr runs a setup wizard:

  1. Create admin account — choose a username and password.
  2. Configure IGDB — enter your IGDB Client ID and Secret (required for game search and metadata).

Note: the IGDB credentials can also be configured via the settings or via .env file.

Getting IGDB credentials

Questarr uses the IGDB API (via Twitch). Register a free application to obtain credentials:

  1. Go to the Twitch Developer Portal.
  2. Click Register Your Application.
  3. Name it Questarr, set the Redirect URI to http://localhost, and choose Application Integration as the category.
  4. Copy the Client ID.
  5. Click New Secret to generate and copy the Client Secret.

Download Clients

Go to Settings → Downloaders → Add Downloader to connect a client.

Supported clients: qBittorrent · Transmission · rTorrent · NZBGet · sabnzbd

Setup steps:

  1. Select your client type.
  2. Enter:
    • Name — display name in Questarr.
    • Host — IP or hostname (e.g. 192.168.1.10 or localhost).
    • Port — Web UI port (qBittorrent: 8080, Transmission: 9091 by default).
    • Username / Password — if authentication is enabled on the client.
    • Category / Label — optional; used to organise downloads in the client.
  3. Click Test Connection, then Save.

Questarr sorts downloaders from highest to lowest priority.

qBittorrent: enable the Web UI under Tools → Options → Web UI and note the port.

Transmission: enable RPC in preferences and set an RPC port (default 9091).

Indexers

Indexers are the sources Questarr searches for game downloads (Torznab / Newznab).

Option 1 — Prowlarr sync (recommended)

  1. Install Prowlarr and configure your indexers there.
  2. In Questarr go to Settings → Indexers and click Sync from Prowlarr.
  3. Enter your Prowlarr URL and API key.
  4. Finish configuration for each indexer, notably setting game categories.

Option 2 — Manual

  1. Go to Settings → Indexers → Add Indexer.
  2. Enter a name, URL, API key, and game categories (typically 4000 for PC Games).
  3. Click Test Connection, then Save.

Like downloaders, indexers can also be sorted by priority.

App Behavior (Settings → General)

Setting Description
Auto-search Automatically trigger indexer searches for wanted/unreleased games on a schedule. Can be disabled globally or per-game.
Preferred Platform When multiple releases are found, prefer this platform (e.g. Steam, GOG).
Preferred Release Groups Comma-separated list of release groups to rank higher in search results.

Steam Wishlist Sync

  1. Go to Settings → General and enter your Steam ID64. You can find it on steamid.io.
  2. Make sure your Steam profile and wishlist are set to Public.
  3. Use the Sync Steam Wishlist button (near Add Game) to import your wishlist into Questarr.

NexusMods Integration

NexusMods trending mods are displayed on game detail pages for applicable titles.

  1. Go to Settings → Integrations.
  2. Enter your NexusMods API key (generate one in your NexusMods account settings).

SSL / HTTPS

SSL support is optional and requires a certificate and key file.

  1. Place your cert.pem and key.pem inside the data volume.
  2. Set SSL_PORT (default 9898) if you want a non-default HTTPS port.
  3. Set APP_URL to your public HTTPS URL so the app can generate correct redirects and security headers.

If TLS is handled by a reverse proxy upstream (e.g. traefik), leave SSL unconfigured in Questarr and set DISABLE_HSTS=true to avoid redirect loops.

Blacklisting Releases

To prevent a specific release from being auto-downloaded or appearing in search results, open the download dialog for that release and click Blacklist. Blacklisted entries can be reviewed in Settings → Blacklist.

Clone this wiki locally