Table of Contents
The definition of a software 'bug' is:
An unexpected behaviour occurring under a given set of conditions
A 'bug' is when something unusual or unexpected happens when you perform a particular action, and this unexpected behaviour should be repeatable when you or another user creates the same conditions with the same qBittorrent version and operating system. If you do find some errant behaviour the first thing to do is to ensure you are using the latest version available for your operating system, see the news page for which that is.
So if your question is "qBittorrent is slow" or "My downloads disappeared when I press [any alphanumeric key] on my keyboard" are NOT a 'bug' and should not be reported as such by opening a new issue on the 'bug tracker'. Visit the qBittorrent Support Forum and ask the question there, but please use the forum search before starting a new thread, almost every problem has been asked and answered before, so adding another "Not uploading" question simply adds to the forum "noise level".
And please, where ever you report your problem, include the qBittorrent version, the operating system you are using, and any execution log entry relevant to the problem and the library versions (Help -> About -> Libraries).
General
- Installing qBittorrent
- Frequently Asked Questions (FAQ)
- qBittorrent options (current and deprecated)
- How to use qBittorrent as a tracker
- How to use portable mode
- Anonymous mode
- How to bind your vpn to prevent ip leaks
Troubleshooting
External programs
Search plugins
Themes
Translation
WebUI
WebUI API
| State | Version |
|---|---|
| Current | qBittorrent ≥ v4.1 |
| Previous | qBittorrent v3.2.0 - v4.0.x |
| Obsolete | qBittorrent < v3.2.0 |
WebAPI clients
Alternate WebUI
Reverse proxy setup for WebUI access
WebUI HTTPS configuration
- Let's Encrypt Certificates + Caddy2 Reverse Proxy
- Let's Encrypt certificates + NGINX reverse proxy - Linux
- Let's Encrypt certificates - Linux
- Self-signed SSL certificates - Linux
Linux
- Running qBittorrent without X server (WebUI only)
- Running qBittorrent without X server (WebUI only, systemd service set up, Ubuntu 15.04 or newer)
- OpenVPN and qBittorrent without X server
Development
- Coding style
- Contributing
- How to write a search plugin
- Using VSCode for qBittorrent development
- Setup GDB with Qt pretty printers
- How to debug WebUI code
Compilation
*BSD, Linux
- Alpine Linux
- CentOS 8.x
- Debian / Ubuntu and derivatives (CMake)
- Debian / Ubuntu and derivatives (autotools/qmake)
- Docker
- FreeBSD (no GUI)
- Fully static binaries on Linux (glibc or musl)
- Raspberry Pi OS / DietPi
- Raspbian for LeMaker Banana Pro