Effortlessly Manage Torrent Downloads with Headless qBittorrent on Linux

Published on


qBittorrent is a popular and open-source torrent client that can be installed on a wide range of operating systems including Linux.

A headless mode means running a program without a GUI (Graphical User Interface), which is ideal for a server setup where a GUI is not required.

In this blog, we will guide you through the process of installing qBittorrent in a headless mode on a Linux server.

Installing qBittorrent in Headless mode

The first step is to update the package list and install the required packages:

sudo apt update
sudo apt install qbittorrent-nox

Once the installation is complete, start the qbittorrent-nox service with the following command:


You can access the qBittorrent interface by visiting the following URL in your web browser: http://localhost:8080

Running qBittorrent in Background with SystemD

Running the command on the terminal directly is fine for testing it out, However, we don't want to block the terminal window whenever we are running qBittorrent.

To run qBittorrent in the background, we can use SystemD, the init system used in modern Linux distributions. Here's how you can do it:

Create a service file by using the following command:

sudo vi /etc/systemd/system/qbittorrent.service

Add the following content to the file:

Description=qBittorrent Daemon



Replace your_username with your system user who would have read/write access (preferably non-root user).

Save and close the file.

Reload the SystemD configuration with the following command:

sudo systemctl daemon-reload

Start the qBittorrent service and enable it to start at boot time with the following commands:

sudo systemctl start qbittorrent
sudo systemctl enable qbittorrent

If you are curious, you can read more in detail about SystemD and how to use it for running background services in one of my previous blog


In this blog, we showed you how to install qBittorrent in a headless mode on a Linux server and how to run it in the background with SystemD. The steps are straightforward and easy to follow, making it convenient for you to set up qBittorrent on your server.

Updates straight in your inbox!

A periodic update about my life, recent blog posts, TIL (Today I learned) related stuff, things I am building and more!

Share with others

Liked it?



You may also like

  • linux

    Running a Service in the Background with SystemV in Linux: A Comprehensive Guide

    Take control of your background services with SystemV in Linux. Learn how to write a SystemV init script, install and start the service, and control its behavior with this comprehensive guide.

    4 min read
  • linux

    Keep Your Services Running in the Background with SystemD

    Do you want your Linux services to keep running even after you log out of your system? SystemD makes it easy to run services in the background. In this guide, we'll show you how to create a SystemD service, start and stop it, and monitor its status.

    3 min read
  • linux

    Init Systems Unveiled — Understanding the Differences between SystemD and SystemV

    Get a comprehensive understanding of SystemD and SystemV init systems in Linux. Explore the similarities and differences between these two init systems, with explanations to help you make an informed decision.

    3 min read