How to Install qBittorrent on Ubuntu 26.04 – Complete Guide

Configure the ideal torrent downloading environment on your Ubuntu machine. Add the developer PPA, manage Flatpak sandbox storage overrides, and establish a headless daemon service with Web UI access.

qBittorrent Installation Methods Compared

Review the installation options below to understand security, package sources, update frequency, and sandboxing details.

Add the official PPA to your system’s software sources:

sudo add-apt-repository ppa:qbittorrent-team/qbittorrent-stable -y

Update your package list so Ubuntu sees the new repository:

sudo apt update

Run the install command to download and install the qBittorrent desktop program:

sudo apt install qbittorrent -y

If Flatpak is not yet configured on your computer, install it and add the Flathub repository:

sudo apt install flatpak -y
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo

Tip: If you are setting up Flatpak for the first time, reboot your system to reload desktop menu paths.

Install the official qBittorrent application from Flathub:

flatpak install flathub org.qbittorrent.qBittorrent -y

By default, Flatpak limits qBittorrent to folders like ~/Downloads. If you want to save files to an external hard drive, secondary drive, or custom folder, you must grant permission using this command:

# Replace /media/MyStorage with your actual downloads directory path
flatpak override --user --filesystem=/media/MyStorage org.qbittorrent.qBittorrent

Alternatively, you can manage Flatpak container settings graphically by installing the Flatseal permission editor utility:

sudo flatpak install flathub com.github.tchx84.Flatseal -y

Open Flatseal, select qBittorrent, scroll to the Filesystem section, and add your target directory path under Other files.

Install the headless qBittorrent package:

sudo apt install qbittorrent-nox -y

For better security, create a dedicated system user account to run the program in the background without admin privileges:

sudo adduser --system --group qbittorrent-nox

Create a systemd service file to manage the program in the background:

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

Paste the following service configuration into the editor:

[Unit]
Description=qBittorrent-nox Service
Wants=network-online.target
After=network-online.target nss-lookup.target

[Service]
Type=exec
User=qbittorrent-nox
Group=qbittorrent-nox
ExecStart=/usr/bin/qbittorrent-nox
Restart=on-failure

[Install]
WantedBy=multi-user.target

Reload systemd, set the service to start automatically at boot, and run the program:

sudo systemctl daemon-reload
sudo systemctl enable qbittorrent-nox.service
sudo systemctl start qbittorrent-nox.service

Verify that the daemon is active and running in the background: sudo systemctl status qbittorrent-nox.service.

To manage your downloads, open a web browser on your network and navigate to http://your-server-ip:8080 (or http://localhost:8080 if running locally).

For security reasons, starting in version 4.6.1+, qBittorrent disabled the default adminadmin password. On startup, a temporary random password is printed in your logs. To retrieve this password, run the following command:

sudo journalctl -u qbittorrent-nox.service --no-pager | grep password

Use username admin and the retrieved password to log in. Once logged in, go to the Tools > Options > Web UI settings tab to set a new, permanent custom username and password.

Uninstall the application packages depending on your active installation format:

For APT and PPA installations:

sudo apt remove qbittorrent qbittorrent-nox -y
sudo apt autoremove --purge -y

For Flatpak (Flathub) installations:

flatpak uninstall org.qbittorrent.qBittorrent -y
flatpak uninstall --unused -y

For headless daemon (systemd) installations:

sudo systemctl stop qbittorrent-nox.service
sudo systemctl disable qbittorrent-nox.service
sudo rm /etc/systemd/system/qbittorrent-nox.service
sudo systemctl daemon-reload
sudo apt remove qbittorrent-nox -y
sudo apt autoremove --purge -y
sudo deluser qbittorrent-nox

If you added the qBittorrent stable Launchpad PPA, delete it from your system configuration directory to prevent update repository warnings:

sudo add-apt-repository --remove ppa:qbittorrent-team/qbittorrent-stable -y
sudo apt update

To delete all saved configuration settings, resume states, and cached log files, execute the clean commands matching your package manager:

# Clean native APT configuration files
rm -rf ~/.config/qBittorrent ~/.local/share/qBittorrent

# Clean Flatpak application caches
rm -rf ~/.var/app/org.qbittorrent.qBittorrent

Refer to the following resources for community support and official documentation: