Table of Contents
First and foremost: Make sure you are using the latest qBittorrent available for your system. You can download the latest version from here: https://qbittorrent.org/
With that out of the way, let's see what can go wrong. The easiest way to see where the problem lies is, disabling everything in between your PC and your Internet Modem. So basically bring your PC to the modem, hook up directly without any router, wifi, anything. Disable Proxy and VPN if you have any and test. Does it work? No? Then try it with a second PC. Still not? Head to our forums and we will help you.
VPN or Proxy?
- If you are using a VPN or Proxy, disable and check if that solves your issue. By default, both solutions render you passive, puts you behind a firewall, so to say. Some VPN providers offer active port forwarding, but it varies by provider.
Other issues/symptoms...
- Check if you have an Anti-Virus or Security solution that comes with a Firewalll. That can cause high CPU usage, connection problems. Thus, affecting your speed and experience.
- If you use a router in your network, make sure you do a port forward by hand. UPnP (the feature that routers use to allow automatic port forward) can be really buggy and they barely ever work. Just add a port for TCP and UDP each by hand, and you are good.
Still not working?
-
Post about it on the forums. Let others help figure out your connection issues: https://qbforums.shiki.hu/ If it is confirmed there after your post, that it's a bug in qBittorrent, make the report. But! Include every detail.
-
Your OS
-
The qBittorrent version you are using
-
What kind of trackers you have been using? Private? Public? You can mention the tracker name too, that's no secret.
-
Architecture (x86 or x86_64, maybe ARM64) you are using
-
Network type: Fiber, cable, DSL, radio/microwave
-
Router: Do you have one? Do you have more than one? Do you have switches in the way?
-
How do you connect to the closest access point? Wifi? Cable? Power-ethernet?
-
What HDDs, SSDs do you download to? Do you use RAID? If yes, hardware, SW? If HW, what adapter/device?
-
Did you check your storage if it works, if it does not have any SMART issues? Use Crystal Disk Info to make sure that the storage is fine. ( https://crystalmark.info/en/software/crystaldiskinfo/ )
-
Did you check your RAM if it is flawless/has no issues? ( https://www.howtogeek.com/260813/how-to-test-your-computers-ram-for-problems/ )
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