qBittorrent gave you a lockup or BSOD (Blue Screen of Death). Now what?
First of all, if you get a BSOD, and it's not irql_not_less_or_equal, there is a good chance you will be able to debug the BSOD. It is a very powerful and useful tool to find why your Windows system just crashed.
You must also know that the cause of your lockup/BSOD was not qBittorrent. There are four major things that can cause a freeze or BSOD. The numbers mean how hard is it to check on a scale of 5.
- Drivers (1/5)
- Your RAM (2/5)
- Your HDD/Storage (2/5)
- Your Power Supply (4/5)
- Something else (5/5)
How to diagnose BSOD
! Take a picture of the BSOD message, every detail. Use your phone, or anything you have at your disposal. You have a few seconds until Windows finishes writing out the memory dump. Wait until it says 100%/ready, otherwise you will have nothing to work with.
If you get the irql_not_less_or_equal, it is most likely a hardware issue.
- Install the Windows SDK. You only need to select the "Debugging tools" at the installation, which is only a mere ~250MB.
- Launch the freshly installed "windbg" as Administrator tool.
- Add remote symbols.
File -> Symbol File Path:
srv*c:\symbols*https://msdl.microsoft.com/download/symbolsThec:\symbolswill be your local symbol cache. I would suggest using something more "writeable". - File -> Open Crash Dump.
- Navigate to
C:\Windows\ - Open
memory.dmp - Wait. Once you see "Ready", use the
!analyze -vcommand. - It will tell you the most likely culprit, but the other loaded things are also suspects. For me, the "most likely" thing was a Windows DLL, but my Avast file scanner service was also there. Removed Avast - boom - no BSOD ever since.
How to check RAM
Windows in-built tool
Alternatives
In case Windows's in-built test does not work for you.
- https://www.memtest86.com
- https://www.howtogeek.com/260813/how-to-test-your-computers-ram-for-problems/
You have to download Memtest86 and put it on a pendrive, CD or DVD. Boot it, and it will check your RAM. I usually stop after 1 PASS, but you can wait until 2 PASS or so. If there are no errors during the test, your ram is OK.
If you can't get Memtest86 to work, a live Ubuntu ISO will work just as well. Download the latest Ubuntu LTS version (16.04 at the moment), and put it on a pendrive, CD or DVD.
How to check the HDD or storage
Windows
There are many great free tools for this.
Ubuntu
If you can't boot Windows, you can use an Ubuntu Live CD to diagnose your HDD.
- https://askubuntu.com/questions/528072/how-can-i-check-the-smart-status-of-a-drive-on-ubuntu-14-04-through-16-10
- https://askubuntu.com/questions/38566/how-can-i-check-the-health-of-my-hard-drive
You want to check:
-
Reallocated_Sector_Ct
-
Current_Pending_Sector
-
Power_On_Hours
-
Reallocated_Sector_Ct:
Once this reaches 1, or any higher, the HDD is a ticking bomb. Back up and replace ASAP. Only store throwaway data on it.
- Current_Pending_Sector: Big trouble. Answer from AskUbuntu:
A sector is marked pending when a read fails. The pending sector will be marked reallocated if a subsequent write fails. If the write succeeds, it is removed from current pending sectors and assumed to be ok. (The exact behavior could differ slightly and I'll go into that later, but this is a close enough approximation for now.)
- Power_On_Hours:
How many hours your HDD ran. HDDs usually die around 20-30k hours. Some may run up to 60k. It is totally random, and there is no guarantee a hard drive will run to X hours. It's however a good idea to back up more often and worry once you reach a lot of hours.
How to check PSU
This one is very tricky. The best and easiest method is to switch the PSU to an other one. Use the computer, try every application, game and whatnot. If the computer is now stable, then it was your PSU.
Of course, most people don't have a second PSU lying around. In this case, it's usually a good test to put load on your PC.
Windows
Run the two programs at the same time. Prime95 stresses your CPU, FurMark stresses your GPU.
If your PC is stable after a few minutes, just close them. If you have a BSOD, or the computer restarts/turns off, you have a bad PSU.
Your PSU might also be able to deliver stable power during stress (not likely), so also test some other situations where you had a freeze/lockup.
Something else
Check if the cables to your HDD/things are connected firmly, and they are not loose. This can also cause trouble. If nothing helped, your motherboard can also be faulty. An anti-virus can also cause BSOD, but it will show up with "windbg".
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