How to Install qBittorrent on Debian 12, 11, or 10

qBittorrent stands out as a reliable torrent client for those prioritizing security and efficiency. This guide will detail the installation process for qBittorrent on Debian 12 Bookworm, Debian 11 Bullseye, or Debian 10 Buster and also cover the steps to set up qBittorrent-nox, the version equipped with WebUI.

Let’s quickly cover some fundamental differences between the qBittorrent installation methods:

qBittorrent Desktop Benefits:

  • User-Friendly Interface: Offers a graphical interface that’s intuitive and easy to navigate.
  • Clean Experience: Being open-source, it’s free from ads and unnecessary bundled software.
  • Feature-Rich: Includes sequential downloading, bandwidth scheduling, and more.

qBittorrent-nox Benefits:

  • Optimized for Headless Systems: Designed for minimal resource usage, ideal for constrained systems.
  • Web Interface: Allows for operations via a web-based interface.
  • Remote Management: Facilitates the management of servers and distant systems through its web interface.

qBittorrent’s commitment to transparency and security is evident in its open-source nature and active development. For those seeking a blend of functionality and user-friendliness in a torrent client, qBittorrent remains a top recommendation, backed by a community-driven approach that ensures it stays attuned to user requirements.

It is now moving on to the main article on installing the BitTorrent software.

Install qBittorrent Desktop on Debian 12, 11, or 10 via APT

In this section, we delve into installing the qBittorrent desktop client on your Debian system and initializing it for the first time. It is essential to keep your system up to date to avoid conflicts and ensure compatibility with the qBittorrent installation.

Step 1: Update Debian Before qBittorrent Installation

Updating the system package list and upgrading the installed packages ensures that you work with the latest software by running the following command:

sudo apt update
sudo apt upgrade

If the upgrade involves updating many packages or the Linux kernel, it is wise to reboot the system for the changes to take effect.

sudo reboot

Step 2: Install qBittorrent Desktop via APT Command on Debian

Having an updated system, you are set to install qBittorrent. This versatile desktop client can be installed directly from Debian repositories. Execute the following command to install qBittorrent:

sudo apt install qbittorrent

This command will retrieve the latest qBittorrent package from the Debian repositories and install it on your system.

Step 3: Launch qBittorrent Desktop Client

With qBittorrent successfully installed, it is time to launch the application. You can do this from the terminal by executing:


This launches the qBittorrent client, and you are now ready to manage your torrents.

You can launch qBittorrent from your system’s application menu if you prefer graphical interfaces. To do this, follow these steps:

Activities > Show Applications > qBittorrent
qBittorrent application icon on Debian Linux desktop.
Visual representation of the qBittorrent application icon located on the Debian Linux desktop.

Step 4: Read Legal Notice From qBittorrent

A legal notice will pop up when you launch qBittorrent for the first time. This notice helps protect qBittorrent from legal issues related to torrent sharing. After you agree to the notice, the main window of qBittorrent will open, and you can start using the software.

Loaded qBittorrent desktop application interface on Debian Linux.
Snapshot of the qBittorrent application when fully loaded on a Debian Linux desktop.

Install qBittorrent-nox on Debian 12, 11, or 10 via APT

In this section, we focus on installing qBittorrent-nox, which is particularly beneficial for running qBittorrent on a headless Debian server or remotely accessed desktop. The WebUI interface enables efficient management of qBittorrent via a web browser.

Step 1: Install qBittorrent-nox on Debian via APT Command

Begin by installing qBittorrent-nox with the command below. It’s tailored for headless systems, and the Web interface can be accessed at the default location http://localhost:8080.

sudo apt install qbittorrent-nox

Step 2: Create a Dedicated System User and Group for qBittorrent

For enhanced security, qBittorrent-nox should run as an unprivileged user. Creating a systemd service unit facilitates this, as it operates in the background and initializes at system boot.

Execute the following command to create a user and group for qBittorrent-nox:

sudo adduser --system --group qbittorrent-nox

The --system flag specifies that this is a system user, which doesn’t have the full capabilities of a regular user.

Step 3: Add Your Username to the qBittorrent-nox Group

To grant your user account the necessary permissions, add it to the qbittorrent-nox group:

sudo adduser your-username qbittorrent-nox

Replace your-username with your actual username.

Step 4: Create a Systemd Service File for qBittorrent-nox

Create a new systemd service file to define how the qBittorrent-nox service should run:

sudo nano /etc/systemd/system/qbittorrent-nox.service

Enter the following content into the file:

Description=qBittorrent Command Line Client

ExecStart=/usr/bin/qbittorrent-nox -d --webui-port=8080


Save and close the file by pressing CTRL+O followed by CTRL+X.

Step 5: Reload the Systemd Daemon

To activate the new service, reload the systemd daemon:

sudo systemctl daemon-reload

Step 6: Start and Enable qBittorrent-nox on Debian

Now, start the qBittorrent-nox service and enable it to start on boot:

sudo systemctl start qbittorrent-nox
sudo systemctl enable qbittorrent-nox
sudo systemctl enable qbittorrent-nox

It’s a good practice to check the status to ensure the service is running smoothly:

systemctl status qbittorrent-nox
Service status of qbittorrent-nox on Debian Linux.
A glimpse into the service status of qbittorrent-nox running on Debian Linux.

If you find an error, the most common issue is the qbittorrent-nox service cannot create the required directories. To fix this, run the following commands:

sudo mkdir /home/qbittorrent-nox
sudo chown qbittorrent-nox:qbittorrent-nox /home/qbittorrent-nox
sudo usermod -d /home/qbittorrent-nox qbittorrent-nox

Then start or restart the service:

sudo systemctl start qbittorrent-nox

Step 7: Access qBittorrent Web UI

Access the qBittorrent Web UI through a browser by entering your server’s internal IP address followed by the port number (8080), like If running locally, use

Remember, the default username is admin, and the password is adminadmin.

Login screen for qbittorrent-nox/WebUI on Debian Linux.
Visual guide of the login screen for qbittorrent-nox or WebUI on Debian Linux platform.
qBittorrent WebUI interface on Debian Linux.
Dive into the appearance and layout of the qBittorrent WebUI on Debian Linux.

It’s paramount to change the default login credentials for security purposes. Navigate through Tools > Options > Web UI > Authentication in the Web UI. Here, you can set a custom username and password.

This step ensures that your qBittorrent Web UI is secure and accessible only to individuals with the proper credentials.

Change password screen for qBittorrent WebUI on Debian Linux.
Visual of updating the password for qBittorrent’s WebUI on Debian Linux.

Additional Commands For qBittorrent on Debian 12, 11 or 10

Update qBittorrent or qBittorrent-nox

To check for updates for qBittorrent or qBittorrent-nox, use the command below:

sudo apt update

You should proceed with the upgrade if an update is available for qBittorrent or qBittorrent-nox with the following command:

sudo apt upgrade

Remove qBittorrent or qBittorrent-nox from Debian

There could be various reasons for wanting to uninstall qBittorrent or qBittorrent-nox, such as system resource management or switching to an alternative application. Whatever the reason, follow this simple process.

To uninstall qBittorrent, enter the following command:

sudo apt remove qbittorrent

If you have installed qBittorrent-nox, which is the headless variant, you can remove it by using the following command:

sudo apt remove qbittorrent-nox


In this guide, we walked through the comprehensive steps to install and manage qBittorrent on Debian versions 10, 11, and 12. We delved into the specifics of setting up qBittorrent-nox, which is ideal for servers and remote configurations. Additionally, we highlighted establishing a systemd service, ensuring that qBittorrent-nox operates seamlessly in the background and initializes upon system startup. Key steps such as adding your user to the qBittorrent-nox group, configuring the systemd service file, and accessing the Web UI were also detailed.

For optimal security, it’s imperative to regularly update the qBittorrent package to benefit from the latest patches and enhancements. Don’t forget to modify the default credentials for the Web UI to bolster safety. By adhering to these guidelines; you can achieve a secure and efficient qBittorrent setup on your Debian platform.

1 thought on “How to Install qBittorrent on Debian 12, 11, or 10”

  1. Thank you for posting this. I had been pulling my hair out trying to get the service started.
    sudo chown qbittorrent-nox:qbittorrent-nox /home/qbittorrent-nox
    sudo usermod -d /home/qbittorrent-nox qbittorrent-nox
    is exactly what I needed.


Leave a Comment