Self-Hosted / Projects / qBittorrent

qBittorrent
StableSpecs verified September 13, 2026 · against v5.2.3
Overview
Self-hosted BitTorrent client and µTorrent alternative with a web UI, RSS filters, and bandwidth controls.
qBittorrent is a free, open-source BitTorrent client and a self-hosted µTorrent alternative. It is a practical fit for a homelab when you want downloads, queueing, search, RSS automation, and remote administration without ads or a vendor account.
Why people choose qBittorrent
The project combines a familiar desktop interface with a remote web UI, so a Linux server can run the client headlessly while you manage it from another device. Its RSS filters, torrent prioritization, bandwidth scheduler, and support for magnet links reduce repetitive download management.
What is included
The official feature list includes a polished µTorrent-like interface, an extensible search engine, category-aware searches, RSS feeds with regex filters, magnet links, DHT, peer exchange, local peer discovery, encrypted connections, queueing, content prioritization, IP filtering, IPv6, and UPnP or NAT-PMP port forwarding.
Requirements and tradeoffs
qBittorrent does not need a separate database. Storage is the main resource decision: allocate space for incomplete and completed downloads, and plan backups for any configuration or data you care about. If you expose the web UI beyond a trusted network, add authentication, HTTPS, and network controls; a BitTorrent client is not a safe internet-facing admin panel by default.
Best fit
Choose qBittorrent when you want a general-purpose BitTorrent client that can run on a homelab server or desktop and remain manageable remotely. If you need media-library automation with metadata, renaming, and download-client orchestration, pair it with a media automation tool rather than treating qBittorrent as the whole stack.
Configuration
Ports
8080/tcp— Common WebUI port; confirm the selected package or image configuration.6881/tcp— Common BitTorrent listening port for TCP; confirm and map the configured port rather than assuming the default.6881/udp— Common BitTorrent listening port for UDP; confirm and map the configured port rather than assuming the default.
Volumes to back up
/config— Persistent client configuration in common container deployments./downloads— Persistent download and completed-content storage in common container deployments.
Interface previews
Screenshots of the qBittorrent interface.
Feature support
| Feature | Support |
|---|---|
| Remote web UIThe official site describes a web interface that is nearly identical to the regular GUI, suitable for remote administration. | Supported |
| RSS feeds with advanced filtersOfficial features include RSS support with advanced download filters, including regular expressions. | Supported |
| Built-in torrent searchThe official site lists an extensible search engine with simultaneous and category-specific searches. | Supported |
| Magnet links and peer discoveryOfficially listed protocol support includes magnet links, DHT, PEX, and local peer discovery. | Supported |
| Encrypted connectionsThe official feature list includes encrypted connections. | Supported |
| Queueing and content prioritizationUsers can queue torrents and prioritize individual torrent content according to the official feature list. | Supported |
| Bandwidth schedulingThe project includes a bandwidth scheduler for time-based limits. | Supported |
| Headless Linux operationThe official screenshots page includes a running headless nox version, and the project provides platform packages and Docker guidance. | Supported |
| UPnP/NAT-PMP forwardingThe official site lists support, but automatic port forwarding depends on router configuration and is not a substitute for deliberate network security. | Partial support |
Community signals
- Stars
- 40.9k
- Forks
- 4.9k
- Open issues
- 2.7k
- Last commit
- 5d ago
- Latest release
- release-5.2.4
- Repo created
- Feb 2012
Includes open pull requests
3w ago
Refreshed nightly from the GitHub API.
Alternatives
- Transmission
Simpler BitTorrent client comparison.
- Deluge
Extensible cross-platform client comparison.
- Sonarr
Media automation comparison when qBittorrent is one part of an *arr workflow.
Questions
What is qBittorrent used for?
qBittorrent is used to download and manage BitTorrent and magnet-link transfers, with queueing, search, RSS automation, bandwidth scheduling, and remote web administration.
Is qBittorrent a µTorrent alternative?
Yes. The official project says its aim is to provide an open-source software alternative to µTorrent, while avoiding ads and vendor lock-in.
Does qBittorrent have a web interface?
Yes. qBittorrent includes a remote web UI that the official site describes as nearly identical to the regular GUI.
Does qBittorrent need a database?
No separate database is required. The important deployment resources are disk space for downloads and a protected location for configuration data.
Can qBittorrent run headless on Linux or in Docker?
Yes. The official screenshots page shows the headless nox version, and the download page links to official Docker image instructions. Check the project guidance for the current image and configuration details.
Does qBittorrent support RSS automation?
Yes. Its official feature list includes RSS feeds with advanced download filters, including regular-expression filtering.
Is the qBittorrent web UI safe to expose to the internet?
Not by default. Protect it with HTTPS, strong authentication, firewall or VPN controls, and updates rather than exposing the administration port directly.
support // the lab
Found this write-up useful?
If it saved you time or a rebuild, you can support more practical homelab guides.