5 How to diagnose IO errors

Chocobo1 edited this page 2024-05-01 17:13:13 +08:00

Table of Contents

• It is very likely that your storage or system has some issue, and there is not much we can do to fix that.
• Check the Execution Log.
• Next step
• Permission problems [Windows]
• Permission problems [Linux]
• Hardware problems [Windows]
• Hardware problems [Linux]

It is very likely that your storage or system has some issue, and there is not much we can do to fix that.

The Issue tracker is no place for helping with your computer. But, you are always welcome to make a topic on our forums, and we will try to help.

Use this wiki article to find out more about what's causing trouble. And always try to fix the problem first yourself. Knowing how to fix computer problems such as this can come in very handy, and it is not hard to do at all. Just don't shy away from a little challenge.

Check the Execution Log.

• On the top bar, click View, Log and then Show
• Click the new Execution Log tab on top

There are quite some data in here but worry not. Just scroll to the bottom and look out for I/O errors. It may contain useful information about why it's happening. Even if you can't make heads or tails of the lines, it will be helpful for the others who will try to help.

Next step

There are two things that can cause (most likely) IO errors and stopped downloads.

• Permission problems
• Faulty drives

Permission problems [Windows]

• If you have the default Download location set up, such as the C:\Users\YOURUSERNAME\Downloads\ folder, your permissions should be fine.
• If you have a custom Download location, make sure you have permissions to read and write there. From Windows 7, permissions have changed. Nowadays, you don't have full write permission by default to your entire C drive, for example, you can only write under your ``C:\Users\YOURUSERNAMEby default. You can, of course, change this - but I don't really recommend it. If you must make a new folder on C, I would make a simpleC:\a` folder, change permissions of that, and put everything I need inside. That way I have no mess, the permissions are alright, and so on.
• If you used a drive on some other PC, Windows remembers the permissions. For example, if you used an external hard drive or a drive with another Windows, or you re-installed your system - you might not have proper permissions anymore.

How to manage permissions on Windows

Permission problems [Linux]

If you are a simple user, and you have your Download folder under your /home - which is the default behaviour - simply use chown to fix your permissions.

1. Open Terminal
2. Type: sudo chown -R USERNAME:USERNAME /home/USERNAME Of course, USERNAME is your username.

If you don't know what's your username, run the command whoami, it will tell you. That's it, ty to download now, things should be working fine.

If you are a GNU/advanced user, check if you belong to the same group as the owner. If the group has RW permissions. Use chmod, chown to fix the permissions.

Hardware problems [Windows]

Check my other Wiki article. See HDD section.

Hardware problems [Linux]

Check my other Wiki article. See HDD section.

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

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

Go back to home