qBittorrent is a cross-platform free and open-source BitTorrent client. qBittorrent is a native application written in C++ which uses Boost, Qt 5 toolkit, and libtorrent-rasterbar library and is extremely lightweight and fast. qBittorrent is very popular amongst torrent users as the main alternative to uTorrent. For Fedora users, this package is maintained in the repository making the installation and updates required for the software relatively easy, given how Fedora works as an upstream release.
In the following tutorial, you will learn how to install qBittorrent on Fedora 37/36/35 Linux desktop GUI and qBittorrent-nox, which can be installed on a desktop or headless server using the command line terminal.
Table of Contents
Recommended Steps Before Installation
Before you continue, your system is advised to ensure all existing packages are up to date to avoid system conflicts.
sudo dnf upgrade --refresh -y
#1st Method – Install qBittorrent – Desktop GUI Client
The first method is installing the qBittorrent GUI Client method, which would suit most users who prefer desktop applications. For users that want to use the WebUI as they run remote servers either at home or remotely, skip this section and install the qBittorrent-nox.
Install the qBittorrent client using the following command.
sudo dnf install qbittorrent -y
Launch qBittorrent – Desktop GUI Client
To launch qBittorrent, type the following command into your current terminal session.
Alternatively, use the following path to launch the application icon.
Activities > Show Applications > qBittorrent
The first you use the program, you will get a pop-up window with a Legal notice. This covers qBittorrent from legal responsibilities as most know torrents are still a significant part of illegal downloads today.
After agreeing to the Legal notice, you will see your newly installed torrent software window.
#2nd Method – Install qBittorrent-nox (Headless Option)
qBittorrent can be installed on a desktop that will be accessed remotely or headless Fedora server and efficiently managed on a WebUI interface accessed from your favorite Browser.
Install qBittorrent using the following command.
sudo dnf install qbittorrent-nox -y
qBittorrent-nox is the default go-to for headless clients designed to run through a Web interface accessible on the default localhost location at http://localhost:8080. The Web UI access is secured by default, the default account username is (admin), and the password is (adminadmin).
Unlike the desktop version, using the terminal command (qbittorrent-nox) would not be advised as a headless server; you won’t be able to do anything while qBittorrent is running, which isn’t practical. Instead, you will create a systemd service unit to run in the background and start at system boot.
First, create a (qbittorrent-nox) user and group so the service can run as an unprivileged user.
sudo groupadd --system --group qbittorrent-nox
If you were wondering what (–system) means, you created a system user instead of a typical user.=
Next, create a qbittorrent username for the qbittorrent-nox user group.
sudo useradd -g qbittorrent-nox qbittorrent-nox
Ideally, you can set a password if you require it.
sudo passwd qbittorrent-nox
Second, create a systemd service file for qbittorrent-nox.
sudo nano /etc/systemd/system/qbittorrent-nox.service
Thirdly, you must copy and paste the following lines into the file.
[Unit] Description=qBittorrent Command Line Client After=network.target [Service] Type=forking User=qbittorrent-nox Group=qbittorrent-nox UMask=007 ExecStart=/usr/bin/qbittorrent-nox -d --webui-port=8080 Restart=on-failure [Install] WantedBy=multi-user.target
Save the file (CTRL+O), then exit (CTRL+X). Now, reload your systemd daemon for changes to be active with the daemon-reload command.
sudo systemctl daemon-reload
Now you can start qBittorrent-nox with the following command.
sudo systemctl start qbittorrent-nox
If you want qBittorrent-nox to be started automatically on boot, use the following.
sudo systemctl enable qbittorrent-nox
Before you continue, it would be ideal to check the status to ensure everything is working correctly.
systemctl status qbittorrent-nox
If there are no errors and status in the green, proceed to the next part of the tutorial.
Accessing qBittorrent Web UI
qBittorrent can be accessed through your local network’s favorite Internet Browser on its Web UI. Type the server’s internal IP address followed by the port number (8080), for example, 192.168.55.156:8080, or use if hosted locally, use the localhost address 127.0.0.1:8080.
You should see the following page.
The default username is (admin), and the default password is (adminadmin).
Once entered, the application will start as below.
Before doing anything else, you should immediately change the default username and password, which can be found following the path.
Tools > Options > Web UI > Authentication.
From here, you can change the username and password.
Congratulations, you have installed qBittorrent.
Update qBittorrent or qBittorrent-nox on Fedora Linux
Using the command line terminal may be more work, but it is often the most efficient way to update your system. All you need to do is run the DNF update command as follows.
sudo dnf update --refresh
For users new to Linux mainly, this blanket checks your entire system for updates, which will be upgraded if one is available for qBittorrent.
Remove qBittorrent or qBittorrent-nox on Fedora Linux
If you would like to remove qBittorrent, this is an easy process. Use the matching command to the installation choice you selected.
Next, remove qBittorrent using the command below.
sudo dnf autoremove qbittorrent
Users that have installed qBittorrent-nox use the following command.
sudo dnf autoremove qbittorrent-nox
And that is it; repeat the tutorial to re-install qBittorrent if you wish it back on your system.