What is qBitrr?

qBitrr is a Python automation tool that connects qBittorrent with the *Arr ecosystem. It monitors torrent health in real time, triggers instant imports when downloads finish, automates searches for missing media and quality upgrades, manages disk space by pausing torrents when space runs low, and integrates with request systems like Overseerr and Ombi. A built-in React WebUI provides live process monitoring, log viewing, Arr library insights, and a configuration editor. It supports multiple qBittorrent instances for load balancing and VPN isolation, per-tracker seeding rules with hit-and-run protection, and automatic updates on a schedule. Installation options include Docker, Docker Compose, pip, pre-built binaries, and systemd services. The project is MIT-licensed and actively maintained.

Should you self-host qBitrr?

qBitrr scores 52/100 on selfhost.directory (how scoring works) and ranks #23 of 45 in Download Management. It has 194 GitHub stars.

It shipped 21 stable releases in the past year. The latest, v5.14.7-2, came out on 26 October 2026. New versions land roughly every 7 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is cobalt (83/100, 45 586 stars). It scores higher overall, so compare the two before you pick. See qBitrr vs cobalt side by side.

Features

Hit and Run Protection

How to configure qBitrr

AuthDisabledfalseDisable authentication (not recommended for exposed instances)
Disable authentication (not recommended for exposed instances)
values: true, false
AutoPauseResumetrueEnable auto pause/resume based on disk space
Enable auto pause/resume based on disk space
values: true, false
AutoRestartProcessestrueAuto-restart crashed worker processes
Auto-restart crashed worker processes
values: true, false
AutoUpdateEnabledfalseEnable automatic qBitrr updates
Enable automatic qBitrr updates
values: true, false
CompletedDownloadFolderCHANGE_MECompleted downloads folder path
Completed downloads folder path
values: path string
FFprobeAutoUpdatetrueAuto-download FFprobe binary
Auto-download FFprobe binary
values: true, false
FreeSpace-1Free space threshold with unit
Free space threshold with unit
values: e.g. 50G, -1
HostCHANGE_MEqBittorrent WebUI host
qBittorrent WebUI host
values: hostname or IP
LocalAuthEnabledfalseEnable username/password login
Enable username/password login
values: true, false
OIDCEnabledfalseEnable OIDC login
Enable OIDC login
values: true, false
PasswordCHANGE_MEqBittorrent password
qBittorrent password
values: string
Port8080qBittorrent WebUI port
qBittorrent WebUI port
values: integer
QBITRR_QBIT_HOSTlocalhostqBittorrent WebUI hostname or IP
qBittorrent WebUI hostname or IP
values: hostname or IP
QBITRR_QBIT_PASSWORDCHANGE_MEqBittorrent WebUI password
qBittorrent WebUI password
values: string
QBITRR_QBIT_PORT8080qBittorrent WebUI port
qBittorrent WebUI port
values: integer
QBITRR_QBIT_USERNAMECHANGE_MEqBittorrent WebUI username
qBittorrent WebUI username
values: string
QBITRR_SETTINGS_AUTO_PAUSE_RESUMEtrueEnable automatic pause/resume of torrents based on free space
Enable automatic pause/resume of torrents based on free space
values: true, false
QBITRR_SETTINGS_AUTO_UPDATE_CHANNELlatestRelease channel for update checks
Release channel for update checks
values: latest, stable, nightly
QBITRR_SETTINGS_AUTO_UPDATE_CRON0 3 * * 0Cron expression for auto-update schedule
Cron expression for auto-update schedule
values: cron expression
QBITRR_SETTINGS_AUTO_UPDATE_ENABLEDfalseEnable automatic qBitrr updates on a schedule
Enable automatic qBitrr updates on a schedule
values: true, false
QBITRR_SETTINGS_COMPLETED_DOWNLOAD_FOLDERCHANGE_MEqBittorrent's completed download folder path
qBittorrent's completed download folder path
values: path string
QBITRR_SETTINGS_CONSOLE_LEVELINFOConsole logging level
Console logging level
values: CRITICAL, ERROR, WARNING, NOTICE, INFO, DEBUG, TRACE
QBITRR_SETTINGS_FREE_SPACE-1 (disabled)Minimum free space to maintain (K/M/G/T units)
Minimum free space to maintain (K/M/G/T units)
values: e.g. 50G, 500M, -1
QBITRR_SETTINGS_FREE_SPACE_FOLDERCHANGE_MEFolder to monitor for free space
Folder to monitor for free space
values: path string
QBITRR_SETTINGS_LOGGINGtrueEnable file logging
Enable file logging
values: true, false
ThemeDarkWebUI theme
WebUI theme
values: Dark, Light
UserNameCHANGE_MEqBittorrent username
qBittorrent username
values: string