How to Install qBittorrent on Linux Mint 21 LTS

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. Some key features include an integrated search engine, web interface for remote control, UPnP/LSD support, priority queuing, select downloads by file extension, IP filtering, and many more. qBittorrent is entirely free and doesn’t contain any ads. It also offers advanced features such as control over every aspect of the client through an integrated graphical user interface, RSS feed support with advanced download filters, bandwidth scheduler, IP blocking, and more. If you’re looking for a feature-rich and lightweight BitTorrent client, qBittorrent should be your go-to.

In the following tutorial, you will learn how to install qBittorrent on Linux Mint 21 LTS release series desktop GUI and install qBittorrent-nox, which can be installed on a desktop or headless server using the command line terminal to access the WEB UI.

Update Linux Mint

First, before anything, update your system to ensure all existing packages are up to date.

sudo apt update && sudo apt upgrade -y

Install Dependencies

Use the following command to install or check if the packages are installed.

sudo apt install dirmngr ca-certificates software-properties-common gnupg gnupg2 apt-transport-https -y

Import qBittorrent PPA

First, import the “qBittorrent Team” team PPA containing the latest version.



Before importing the GPG key, users will often have issues importing GPG keys from LaunchPAD PPAs due to the directories not being created. This is an easy fix. Use the following command that will, in turn, generate the directories.

sudo gpg --list-keys

Example output:

How to Install qBittorrent on Linux Mint 21 LTS

As above, the necessary directories have been created. This can be skipped, and use the following GPG import command below. If you have any issues with directories missing for this and any other PPA GPG key in the future, just run the above command.

Lastly, import either the stable or unstable PPA. I recommend installing the stable version for most users, as it’s pretty often updated with the latest stable version. Bleeding-edge users wanting the latest release use the unstable, but bugs may occur.

Use the following command to import the GPG key for the PPA.

sudo gpg --no-default-keyring --keyring /usr/share/keyrings/qbittorrent.gpg --keyserver keyserver.ubuntu.com --recv-keys 401E8827DA4E93E44C7D01E6D35164147CA69FC4

Import qBittorrent Stable (Recommended)

Import the stable PPA.



echo 'deb [signed-by=/usr/share/keyrings/qbittorrent.gpg] https://ppa.launchpadcontent.net/qbittorrent-team/qbittorrent-stable/ubuntu/ jammy main' | sudo tee -a /etc/apt/sources.list.d/qbittorrent.list

Import qBittorrent Unstable (Nightly)

Import the unstable PPA.

echo 'deb [signed-by=/usr/share/keyrings/qbittorrent.gpg] https://ppa.launchpadcontent.net/qbittorrent-team/qbittorrent-unstable/ubuntu jammy main' | sudo tee -a /etc/apt/sources.list.d/qbittorrent.list

Install qBittorrent – Desktop GUI Method

With the repository now imported, run a quick APT update to reflect the newly added PPA, which you will install qBittorrent from.

sudo apt update

Now you can install qBittorrent using the following command.

sudo apt install qbittorrent -y

How to Launch qBittorrent – Desktop GUI Method

To launch qBittorrent, type the following command into your current terminal session.

qbittorrent

Alternatively, use the following path to launch the application icon.

Taskbar > Internet > qBittorrent



Example:

How to Install qBittorrent on Linux Mint 21 LTS

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.

Example:

How to Install qBittorrent on Linux Mint 21 LTS

After agreeing to the Legal notice, you will see your newly installed torrent software window.

Example:

How to Install qBittorrent on Linux Mint 21 LTS

Install qBittorrent-nox – Server Method

qBittorrent can be installed on a desktop or even a headless server like Ubuntu and efficiently managed on a WebUI interface accessed from your favorite Browser.



Next, run a quick APT update to reflect the newly added PPA if you have not done so already.

sudo apt update

Now you can install qBittorrent using the following command.

sudo apt 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 (qbittorrent-nox) user and group so the service can run as an unprivileged user.

sudo adduser --system --group qbittorrent-nox

If you were wondering what (–system) means, you created a system user instead of a typical user.



Next, add your username to the qbittorrent-nox user group.

sudo adduser your-username qbittorrent-nox

Example using my username:

sudo adduser joshua qbittorrent-nox

Example output:

How to Install qBittorrent on Linux Mint 21 LTS

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

Example:



How to Install qBittorrent on Linux Mint 21 LTS

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 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.

How to Install qBittorrent on Linux Mint 21 LTS

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.

Example:

How to Install qBittorrent on Linux Mint 21 LTS

The default username is (admin), and the default password is (adminadmin).

Once entered, the application will start as below.

Example:

How to Install qBittorrent on Linux Mint 21 LTS

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.

Example:

How to Install qBittorrent on Linux Mint 21 LTS

Congratulations, you have installed qBittorrent.

How to Update/Upgrade qBittorrent/qBittorrent-nox

Using the command line terminal may be more work but is often the most efficient way to update your system. All you need to do is run the apt update command as follows.

sudo apt update

If an update is available for qBittorrent or qBittorent-nox, use the following upgrade command.



sudo apt upgrade

How to Remove (Uninstall) qBittorrent/qBittorrent-nox

If you would like to remove qBittorrent, this is an easy process. First, you must remove the custom PPA if installed per the above tutorial.

For Desktop GUI installations, use the following command to remove qBittorrent.

sudo apt autoremove qbittorrent

Users that have installed qBittorrent-nox use the following command.

sudo apt autoremove qbittorrent-nox

Remove the PPA that you imported with the following command.

sudo rm /usr/share/keyrings/qbittorrent.gpg /etc/apt/sources.list.d/qbittorrent.list

And that is it; repeat the tutorial to re-install qBittorrent if you wish it back on your system.

Comments and Conclusion

qBittorrent is a great torrent client that will work on any operating system. It has more features than Transmission, but without the bloatware and ads. If you are looking for a good torrent client, qBittorrent is worth considering.




Not what you were looking for? Try searching for additional tutorials.

Leave a Comment