If your user name and password is locked out of the Web UI and the default user name admin
and password adminadmin
is also failing, the steps to recover access are:
-
Log in to the machine the client is on as the user that qbittorrent runs as, either at the console or over an SSH connection.
-
Exit or kill qBittorrent process.
-
Navigate to
~/.config/qBittorrent/
(or/<qbittorrent user name>/.config/qBittorrent/
) and edit the configuration fileqBittorrent.conf
.- If you're using qbittorrent version < 4.2.0, locate the line starting with
WebUI\Password_ha1
and remove the entire line. - If you're using qbittorrent version ≥ 4.2.0, locate the line starting with
WebUI\Password_PBKDF2
and remove the entire line.
- If you're using qbittorrent version < 4.2.0, locate the line starting with
-
Save and close the file and start qBittorrent.
-
You should then be able to login the WebUI using your usual username and the default password
adminadmin
. -
Remember to update it to your preferred password, otherwise your machine is prone to be hacked.
ps. If you are still unable to login check if your antivirus is not blocking sending password via unencrypted connection (http). Bitdefender seems to do it by default, you need to whitelist qbittorrent server URL.
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