Home

Everyone is welcome to edit and improve the wiki!

👉 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

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 v4.1+
Previous	qBittorrent v3.2.0-v4.0.4
Obsolete	qBittorrent v3.1.x

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)
• Running qBittorrent without X server (WebUI only + daemon setup on alternative init systems) - TODO
• 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

CMake

• Common information
• Debian/Ubuntu and derivatives
• Alpine Linux
• Windows (MSVC 2019, static linkage)
• Windows (MSVC 2019, dynamic linkage) TODO
• Windows (MinGW 64-bit, dynamic linkage) TODO
• macOS (x86_64, arm64, cross-compilation, static linkage)

qmake/autotools

• CentOS 8.x
• Debian / Ubuntu compilation
• Raspberry Pi OS / DietPi
• Raspian for LeMaker Banana Pro
• FreeBSD (no GUI)
• Fully static binaries on Linux (glibc or musl)
• macOS
• MSVC 2019 (static linkage)
• Compiling with MSYS2

---

• Obsolete compilation guides