How to Install qBittorrent on Ubuntu

qBittorrent is the open-source BitTorrent client many Ubuntu users pick after Transmission—integrated search, RSS, sequential downloads, and a familiar µTorrent-style interface without ads. On a desktop Ubuntu install you want the qbittorrent package (Qt GUI). On a server or NAS without a display, you want qbittorrent-nox and the Web UI instead—covered in install qBittorrent-nox on Ubuntu.

This guide shows how to install qBittorrent on Ubuntu using universe apt (simplest), the official qbittorrent-stable PPA (newest stable builds), and Flatpak from Flathub. It also explains which Snap packages to avoid, how to complete the legal notice on first launch, and where to go for CLI torrenting when you do not need a GUI at all.

Tested on: Ubuntu 25.04 (Plucky Puffin); kernel 6.14.0-37-generic; qbittorrent 5.0.4-1 from universe.

Quick command summary

What is qBittorrent—and which package do you need?

qBittorrent is a BitTorrent client built with Qt and libtorrent-rasterbar. It supports magnet links, RSS, IP filtering, sequential downloads, and a built-in search engine (where enabled by your jurisdiction and version).

If you are reading an install qbittorrent ubuntu tutorial for your laptop, you almost certainly want qbittorrent. If the goal is a torrent box in the closet with no monitor, stop here and open the qbittorrent-nox guide.

Prerequisites

• Ubuntu Desktop 22.04 LTS, 24.04 LTS, or newer (25.04 tested here) on amd64 or arm64 (package names match; verify with apt-cache policy qbittorrent).
• A working graphical session (Wayland or X11)—the GUI client does not run meaningfully over plain SSH without a display.
• sudo for package installation.
• universe enabled in apt sources (qbittorrent lives in universe).
• software-properties-common if you plan to add the PPA and add-apt-repository is missing—see add-apt-repository command not found.
• Enough disk space under your download directory—check disk space before large Linux ISO torrents.

Right and wrong ways to install (read this first)

Community posts—including r/qBittorrent PSA threads—repeat the same advice the official install wiki gives:

Pick one packaging path per machine. Mixing PPA and universe without checking apt-cache policy leads to confusing upgrades—or, on bleeding-edge releases, occasional library mismatch errors after a PPA upgrade. If qbittorrent fails to launch after a PPA update, pin universe: sudo apt install --allow-downgrades qbittorrent=5.0.4-1 (adjust version to what apt-cache policy shows).

Step 1: Install qBittorrent from Ubuntu apt (recommended baseline)

Refresh indexes and compare universe vs any PPA you already have:

sudo apt update
apt-cache policy qbittorrent

On Ubuntu 25.04 without the PPA:

qbittorrent:
 Candidate: 5.0.4-1
 Version table:
 5.0.4-1 500
 500 http://archive.ubuntu.com/ubuntu plucky/universe amd64 Packages

Install with apt:

sudo apt install -y qbittorrent

Confirm the package:

dpkg -l qbittorrent

ii qbittorrent 5.0.4-1 amd64 bittorrent client based on libtorrent-rasterbar with a Qt GUI

The install pulls Qt 6, libtorrent-rasterbar, and a .desktop file at /usr/share/applications/org.qbittorrent.qBittorrent.desktop.

Step 2: Install from the official qbittorrent-stable PPA

When universe lags behind qBittorrent downloads and you want 5.1.x or newer on Ubuntu, add the official stable PPA:

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

With the PPA enabled on 25.04, the candidate may jump to a 5.1.4.x build while universe stays on 5.0.4-1:

qbittorrent:
 Candidate: 1:5.1.4.99~202511192332-8742-33e5e7722~ubuntu25.04.1
 Version table:
 1:5.1.4.99~... 500
 500 https://ppa.launchpadcontent.net/qbittorrent-team/qbittorrent-stable/ubuntu plucky/main amd64 Packages
 5.0.4-1 500
 500 http://archive.ubuntu.com/ubuntu plucky/universe amd64 Packages

Install:

sudo apt install -y qbittorrent

Open qBittorrent from the application menu and confirm it starts. If you see a symbol lookup error involving libtorrent, downgrade to the universe package until the PPA publishes a fixed build:

sudo apt install -y --allow-downgrades qbittorrent=5.0.4-1

That edge case showed up on my test VM when upgrading from universe to PPA—your mileage may vary by release day, but universe is the rollback that worked.

Step 3: Install qBittorrent from Flathub (Flatpak)

Flathub ships a semi-official Flatpak with sandboxing—useful when you want isolation from system Qt libraries or you are on a distro-variant that favors Flatpak.

Install Flatpak if needed:

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

Install qBittorrent:

flatpak install -y flathub org.qbittorrent.qBittorrent

Run:

flatpak run org.qbittorrent.qBittorrent

Flatpak builds may lag or lead universe by a few days—check Flathub for the current version before you assume parity with the PPA.

Step 4: Snap and other unofficial packages (usually skip)

snap find qbittorrent surfaces community packages such as qbittorrent-arnatious on old 4.3.x releases—not the current upstream line. Unless you have a specific reason to use them, prefer apt, the official PPA, or Flathub.

Similarly, unofficial Snap publishers (tak, etc.) may track different branches (desktop vs nox). Read the Snap description carefully; nox belongs on servers, not on a desktop you expect to open from the app grid.

First launch: legal notice and basic setup

1. Open Activities → search qBittorrent → launch.
2. Read the legal notice and accept—required on every fresh profile.
3. Optional: Tools → Options → Downloads set default save path (often ~/Downloads).
4. Add a torrent: File → Add Torrent File or paste a magnet link.

To open a .torrent file from the terminal on a desktop session:

xdg-open ~/Downloads/example.torrent

For legal Linux ISO torrents, many projects publish .torrent files beside HTTP downloads—same pattern as downloading torrents from CLI but with a GUI queue.

qBittorrent desktop vs qbittorrent-nox (when to switch guides)

The qBittorrent Web UI wiki describes nox + systemd—that is the server path, not the desktop qbittorrent package.

Uninstall qBittorrent

APT / PPA:

sudo apt purge -y qbittorrent
sudo apt autoremove -y

Remove the PPA when you no longer need it:

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

Flatpak:

flatpak uninstall org.qbittorrent.qBittorrent

Config and resume data live under ~/.config/qBittorrent/—delete that directory only when you do not need saved settings or torrent lists.

Troubleshooting

References

• qBittorrent — official download
• qBittorrent wiki — Installing qBittorrent
• qBittorrent stable PPA on Launchpad
• Flathub — org.qbittorrent.qBittorrent
• r/qBittorrent — right and wrong ways to install
• Ubuntu archive — qbittorrent packages
• On-site: qbittorrent-nox on Ubuntu, CLI torrent download, apt command, must-have Ubuntu apps

Summary

The reliable way to install qBittorrent on Ubuntu Desktop is sudo apt update && sudo apt install -y qbittorrent from universe, then launch qBittorrent from the app menu and accept the legal notice. When you need newer upstream builds, add ppa:qbittorrent-team/qbittorrent-stable—the official PPA recommended by the project wiki—and verify the GUI starts cleanly.

Avoid outdated community Snap builds; use Flathub when you want a sandboxed install. For servers without a desktop, install qbittorrent-nox instead and follow the Web UI / systemd guide. For terminal-only workflows, see download torrent from CLI on Ubuntu.