Home · qbittorrent/qBittorrent Wiki · GitHub
Skip to content
You signed in with another tab or window.
Reload
to refresh your session.
You signed out in another tab or window.
Reload
to refresh your session.
You switched accounts on another tab or window.
Reload
to refresh your session.
Dismiss alert
qbittorrent
qBittorrent
Public
Uh oh!
There was an error while loading.
Please reload this page
Notifications
You must be signed in to change notification settings
Fork
4.6k
Star
36.7k
Jump to bottom
Thomas Piccirello edited this page
Feb 8, 2026
153 revisions
Everyone is welcome to improve the wiki!
The wiki source code is hosted at
and is accepting Pull Requests.
👉 If you create a page, place it below in its respective place and update the sidebar with the content below.
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
qBittorrent support forum
I forgot my GUI lock password
I forgot my WebUI password
Speed issues
External programs
How-to
savecategory
Search plugins
List of unofficial search plugins
Themes
Developing custom UI themes
How to use custom UI themes
List of unofficial themes
Translation
How to translate qBittorrent
WebUI
WebUI API
State
Version
Current
qBittorrent >= 5.0
Previous
qBittorrent v4.1.0 - v4.6.x
Previous
qBittorrent v3.2.0 - v4.0.x
Obsolete
qBittorrent < v3.2.0
Authentication
Username/password
API key
WebAPI clients
List of unofficial WebAPI clients
Alternate WebUI
Alternate WebUI usage
Developing alternate WebUIs
List of unofficial alternate WebUIs
Reverse proxy setup for WebUI access
NGINX
(canonical source for reverse proxy settings)
Microsoft IIS ARR
Traefik
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
Common information for CMake
*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
macOS
cmake (x86_64, arm64, cross-compilation, static linkage)
autotools/qmake
Windows
MSVC 2019 (CMake, static linkage)
MSVC 2019 (qmake, static linkage)
MSYS2
Obsolete compilation guides
Go back to home
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
qBittorrent support forum
I forgot my GUI lock password
I forgot my WebUI password
Speed issues
External programs
How-to
savecategory
Search plugins
List of unofficial search plugins
Themes
Developing custom UI themes
How to use custom UI themes
List of unofficial themes
Translation
How to translate qBittorrent
WebUI
WebUI API
State
Version
Current
qBittorrent >= 5.0
Previous
qBittorrent v4.1.0 - v4.6.x
Previous
qBittorrent v3.2.0 - v4.0.x
Obsolete
qBittorrent < v3.2.0
Authentication
Username/password
API key
WebAPI clients
List of unofficial WebAPI clients
Alternate WebUI
Alternate WebUI usage
Developing alternate WebUIs
List of unofficial alternate WebUIs
Reverse proxy setup for WebUI access
NGINX
Microsoft IIS ARR
Traefik
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
Common information for CMake
*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
macOS
cmake (x86_64, arm64, cross-compilation, static linkage)
autotools/qmake
Windows
MSVC 2019 (CMake, static linkage)
MSVC 2019 (qmake, static linkage)
MSYS2
Obsolete compilation guides
Clone this wiki locally
You can’t perform that action at this time.