How to Install qBittorrent on Ubuntu 26.04, 24.04 and 22.04

Install qBittorrent on Ubuntu when you want a BitTorrent client that handles magnet links, RSS rules, search plugins, sequential downloads, and long-running transfers without ads or bundled extras. Ubuntu 26.04, 24.04, and 22.04 all package qBittorrent in the Universe repository; 26.04 currently ships the newer 5.1.x series, while 24.04 and 22.04 use older 4.x packages unless you switch to the qBittorrent Team PPA or the Flathub build. The same package family also provides qbittorrent-nox for Ubuntu Server or other headless systems where you manage torrents through the Web UI.

Install qBittorrent on Ubuntu

Most desktop users on Ubuntu 26.04 can install from the default repository immediately. On Ubuntu 24.04 or 22.04, choose between the default repository for the distro-maintained build, the stable PPA for a newer native package, or Flatpak for the current upstream desktop release. The official qBittorrent download page also offers AppImages, but APT and Flatpak are easier to update and remove cleanly on Ubuntu.

Method	Channel	Version	Updates	Best For
Default repository	Ubuntu Universe	5.1.x (26.04), 4.6.x (24.04), 4.4.x (22.04)	Standard APT updates	Native install with no third-party repository
Stable PPA	qBittorrent Team PPA	4.6.x (24.04), 4.5.x (22.04)	PPA-tracked APT updates	Newer native packages on 24.04 or 22.04
Flatpak	Flathub	5.1.x	flatpak update	Sandboxed desktop build on any supported Ubuntu LTS
qBittorrent-nox	Ubuntu Universe or stable PPA	Matches the selected APT source	APT updates	Ubuntu Server and browser-managed headless installs

Ubuntu 26.04 users should install from the default repository, which already ships qBittorrent 5.1.x and requires no PPA. The qBittorrent Team stable PPA currently targets 24.04 and 22.04 only; attempting to add it on 26.04 fails because there is no resolute release metadata. On 24.04 and 22.04, the stable PPA is optional and provides newer native packages than the default repository.

Update Ubuntu Before Installing qBittorrent

Refresh the package lists and install available upgrades:

sudo apt update

All commands in this guide use sudo. If your account is not in the sudoers file, follow our guide on adding a user to sudoers on Ubuntu before continuing.

Upgrade any outdated packages:

sudo apt upgrade

For a complete reference on refreshing and upgrading packages, review the Ubuntu package update guide.

qBittorrent is in Ubuntu’s Universe repository. If a minimal install cannot locate the package, enable Universe with the Ubuntu Universe repository guide, then run sudo apt update again.

Add the qBittorrent PPA on Ubuntu (Optional on 24.04 and 22.04)

The add-apt-repository command requires the software-properties-common package. Most Ubuntu desktop installations include this by default, but minimal server setups may need it:

sudo apt install software-properties-common

Import the qBittorrent Team stable PPA only on Ubuntu 24.04 or 22.04. The unstable PPA currently exposes release metadata but no installable qBittorrent packages for these supported Ubuntu releases, so use the stable PPA when you want the newer native package.

Import the stable PPA:

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

The -y flag automatically confirms the PPA addition and refreshes the package index, so you can proceed directly to installation.

Install the qBittorrent Desktop Client

Install the qBittorrent desktop client. On Ubuntu 24.04 and 22.04, this pulls from the stable PPA only if you added it earlier; otherwise APT uses the default Universe package. On Ubuntu 26.04, use the default repository:

sudo apt install qbittorrent

Verify the installed version:

qbittorrent --version

Expected output varies by Ubuntu release and installation source:

• Ubuntu 26.04 (default repository): qBittorrent v5.1.4
• Ubuntu 24.04 (default repository): qBittorrent v4.6.3
• Ubuntu 24.04 (stable PPA): qBittorrent v4.6.7
• Ubuntu 22.04 (default repository): qBittorrent v4.4.1
• Ubuntu 22.04 (stable PPA): qBittorrent v4.5.5

Launch qBittorrent on Ubuntu

Launch the qBittorrent desktop client from the terminal:

qbittorrent

You can also launch qBittorrent from the applications menu:

Activities > Show Applications > qBittorrent

Upon first launch, qBittorrent displays a legal notice. Accept it to reach the main interface.

Install qBittorrent via Flatpak on Ubuntu

Flatpak provides qBittorrent in a sandboxed environment (isolated from your system files) with the latest upstream version. This method works identically on Ubuntu 26.04, 24.04, and 22.04, making it a reliable cross-version option when the PPA is unavailable or you prefer application isolation.

Flatpak is not pre-installed on Ubuntu. If you have not set it up yet, install it with sudo apt install flatpak and restart your session before continuing. For detailed setup including the Flathub repository, follow our Flatpak installation guide for Ubuntu.

Install qBittorrent from Flathub:

flatpak install flathub org.qbittorrent.qBittorrent -y

Verify the Flatpak metadata without launching the GUI:

flatpak info org.qbittorrent.qBittorrent

Expected output:

qBittorrent - An open-source Bittorrent client

          ID: org.qbittorrent.qBittorrent
         Ref: app/org.qbittorrent.qBittorrent/x86_64/stable
     Version: 5.1.4

Launch qBittorrent from the applications menu or run flatpak run org.qbittorrent.qBittorrent from the terminal. The Flatpak version receives updates through flatpak update independently of APT.

Install qBittorrent-nox on Ubuntu for Headless Server Use

For Ubuntu Server, qBittorrent-nox provides the same core client without a graphical desktop. The daemon runs in the background and exposes a Web UI that you can manage from a browser on your LAN or through a secured reverse proxy.

Community Docker images for qBittorrent also exist, but they are outside this native Ubuntu package workflow. Use qBittorrent-nox when you want the package manager, systemd, and Ubuntu firewall commands to manage the service directly.

Install qBittorrent-nox on Ubuntu

Install qBittorrent-nox with the standard APT command:

sudo apt install qbittorrent-nox

Verify the installed version:

qbittorrent-nox --version

Expected output varies by Ubuntu release and installation source:

• Ubuntu 26.04 (default repository): qBittorrent v5.1.4
• Ubuntu 24.04 (default repository): qBittorrent v4.6.3
• Ubuntu 24.04 (stable PPA): qBittorrent v4.6.7
• Ubuntu 22.04 (default repository): qBittorrent v4.4.1
• Ubuntu 22.04 (stable PPA): qBittorrent v4.5.5

The install does not start the daemon automatically. Systemd service availability depends on your package source and Ubuntu version:

• Ubuntu 26.04 default repository (version 5.1.4): The templated systemd unit (qbittorrent-nox@.service) is included.
• Ubuntu 24.04 default repository (version 4.6.3): The templated systemd unit is included.
• PPA installations (24.04 or 22.04): The templated systemd unit is included.
• Ubuntu 22.04 default repository (version 4.4.1): No systemd unit is included. You must create one manually (see below).

The Web UI listens on port 8080 by default. The username is admin. qBittorrent 4.6.1 and newer generate a temporary password until you save your own credentials; Ubuntu 22.04’s default 4.4.1 package still starts with the legacy admin / adminadmin credentials.

Choose the Account that Runs qBittorrent-nox on Ubuntu

The PPA and Ubuntu 24.04/26.04 default repository packages ship a templated systemd unit (qbittorrent-nox@.service) under /usr/lib/systemd/system/ that runs under whatever username you supply after the @ symbol. Decide whether to run the daemon as your regular login or a dedicated service account so downloaded files stay isolated.

If you prefer a dedicated account, create one with a system user that owns its own home directory:

sudo adduser --system --group --home /var/lib/qbittorrent qbittorrent

The --system flag creates a locked-down user that cannot log in interactively, which keeps the torrent service separate from your daily desktop profile. The explicit --home /var/lib/qbittorrent argument is important: without it, adduser defaults to /nonexistent for system accounts, and the qbittorrent-nox service will fail because it has nowhere to store its configuration. Skip this step entirely if you plan to run the service as your regular username.

Enable the qBittorrent-nox Systemd Service on Ubuntu

Enable and start the built-in systemd service with your chosen username. The --now flag starts the service immediately in addition to enabling it for future boots. Replace USERNAME with your actual username (run whoami to check), or use the shell substitution shown:

sudo systemctl enable --now qbittorrent-nox@$(whoami)

The $(whoami) substitution automatically inserts your current username. If you created the dedicated qbittorrent service user earlier, replace $(whoami) with qbittorrent instead.

Verify the service started successfully:

systemctl status qbittorrent-nox@$(whoami)

The status output should include these stable lines for a running service:

qbittorrent-nox@username.service - qBittorrent-nox service for user username
     Loaded: loaded (/usr/lib/systemd/system/qbittorrent-nox@.service; enabled; preset: enabled)
     Active: active (running)

The qBittorrent package maintains the templated unit, so you only need a custom override file if you plan to change advanced options such as ExecStart flags or custom environment variables.

Create a qBittorrent-nox Systemd Service (Ubuntu 22.04 Only)

Ubuntu 22.04’s default repository ships qBittorrent-nox version 4.4.1, which does not include a systemd service file. If you installed from the default repository on Ubuntu 22.04 without the PPA, create the service file manually. Skip this section on Ubuntu 26.04, Ubuntu 24.04, or stable PPA installations because those packages include the templated unit.

Create the systemd service file:

sudo tee /etc/systemd/system/qbittorrent-nox@.service <<'EOF'
[Unit]
Description=qBittorrent-nox service for user %I
Documentation=man:qbittorrent-nox(1)
Wants=network-online.target
After=local-fs.target network-online.target nss-lookup.target

[Service]
Type=simple
PrivateTmp=false
User=%i
ExecStart=/usr/bin/qbittorrent-nox
TimeoutStopSec=1800

[Install]
WantedBy=multi-user.target
EOF

The After=local-fs.target network-online.target nss-lookup.target line mirrors the packaged unit used by newer Ubuntu and PPA builds. TimeoutStopSec=1800 gives qBittorrent-nox up to 30 minutes to finish active transfers during a graceful shutdown.

Reload the systemd daemon to recognize the new service:

sudo systemctl daemon-reload

Enable and start the service using the same commands as the PPA installation:

sudo systemctl enable --now qbittorrent-nox@$(whoami)

Ubuntu 22.04’s version 4.4.1 predates the temporary password feature introduced in 4.6.1, so the default credentials are admin / adminadmin. Change these immediately after first login through the Web UI settings.

Access the qBittorrent Web UI and Retrieve the Default Password

With the service running, open the qBittorrent Web UI in your browser. Type the server’s internal IP address followed by the port number (8080), for example, 192.168.55.156:8080. If hosted locally, use the localhost address 127.0.0.1:8080.

For remote access, ensure your firewall allows traffic on port 8080. Ubuntu users running UFW can open the port:

sudo ufw allow 8080/tcp

The Web UI transmits credentials in plain text over HTTP. If you access it over an untrusted network, place it behind a reverse proxy with HTTPS or restrict the firewall rule to your local subnet. Set a strong password immediately after first login.

The Web UI username defaults to admin. Password behavior depends on your qBittorrent version:

• Version 4.6.1 and newer (Ubuntu 26.04, 24.04 default repository, or PPA): A temporary password is generated on each launch.
• Version 4.4.1 (Ubuntu 22.04 default repository): Default credentials are admin / adminadmin.

Upstream developers removed the legacy admin/adminadmin WebUI credentials starting with qBittorrent 4.6.1. The daemon now generates a random temporary password each time it starts without saved credentials and prints it to stdout once. See the upstream issue #19984, which also documents why you must read this message from the systemd journal in headless deployments.

Check the service logs to retrieve the temporary password. The -n 50 flag limits output to the last 50 journal entries, and grep isolates the password line. The $(whoami) substitution automatically inserts your current username:

sudo journalctl -u qbittorrent-nox@$(whoami) -n 50 | grep -i "temporary password"

If you created a dedicated qbittorrent service user, replace $(whoami) with qbittorrent in all systemd and journalctl commands.

If the password line does not appear, restart the service and follow the log stream in real time:

sudo systemctl restart qbittorrent-nox@$(whoami) && sudo journalctl -fu qbittorrent-nox@$(whoami)

Look for the temporary-password line. The actual password appears after the colon in your journal output:

******** Information ********
The WebUI administrator username is: admin
The WebUI administrator password was not set. A temporary password is provided for this session:
You should set your own password in program preferences.

Sign in with username admin and the temporary password that appears in your log. Each restart generates a new temporary password until you store permanent credentials.

Immediately set your own username and password from the Web UI by opening the gear icon (Options) and navigating to Web UI > Authentication.

After saving your credentials, restart the daemon to apply the change:

sudo systemctl restart qbittorrent-nox@$(whoami)

Reopen the Web UI and confirm your new credentials work. The temporary password message will no longer appear after you save permanent credentials.

Troubleshoot Common qBittorrent Issues on Ubuntu

Fix qBittorrent-nox Service Startup Failures

If the qBittorrent-nox service fails to start, check the logs for specific error messages:

sudo journalctl -xeu qbittorrent-nox@$(whoami) --no-pager | tail -30

A common error message looks like:

qbittorrent-nox: /nonexistent: No such file or directory

This means the user’s home directory doesn’t exist. If you created a system user with the --home flag, verify the directory was created and has correct ownership:

ls -la /var/lib/qbittorrent

Fix qBittorrent PPA Failure on Ubuntu 26.04

If you attempt to add the qBittorrent PPA on Ubuntu 26.04, the command will fail because the PPA does not include packages for this release. The error looks like:

E: The repository 'https://ppa.launchpadcontent.net/qbittorrent-team/qbittorrent-stable/ubuntu resolute Release' does not have a Release file.

Ubuntu 26.04 ships qBittorrent 5.1.x in the default repository, which is newer than the PPA versions available for 22.04 and 24.04. Remove any partially added PPA entries and install from the default repository instead:

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

Fix qBittorrent-nox Temporary Password Not Appearing

If the temporary password line doesn’t appear in the journal output, the service may not have restarted since you last logged in. Restart the service and watch the logs in real time:

sudo systemctl restart qbittorrent-nox@$(whoami) && sudo journalctl -fu qbittorrent-nox@$(whoami)

The temporary password appears only once per restart. After you save permanent credentials through the Web UI, the password message stops appearing.

Reset qBittorrent-nox Web UI Credentials

If you saved credentials and later lose access, stop the service and move qBittorrent.conf aside before restarting. This backs up the file instead of deleting it, but it also resets other preferences stored in that configuration file.

sudo systemctl stop qbittorrent-nox@$(whoami)
mkdir -p ~/.config/qBittorrent-backup
mv ~/.config/qBittorrent/qBittorrent.conf ~/.config/qBittorrent-backup/qBittorrent.conf.bak
sudo systemctl start qbittorrent-nox@$(whoami)
sudo journalctl -u qbittorrent-nox@$(whoami) -n 50 | grep -i "temporary password"

For a dedicated qbittorrent service account, stop qbittorrent-nox@qbittorrent and move /var/lib/qbittorrent/.config/qBittorrent/qBittorrent.conf instead. On Ubuntu 22.04’s default 4.4.1 package, the reset returns the Web UI to admin / adminadmin; change it immediately after logging in.

Fix qBittorrent Web UI Not Accessible

If you cannot reach the Web UI from a remote machine, verify the firewall rule is active and the service is listening:

sudo ufw status | grep 8080
ss -tln 'sport = :8080'

Expected output for the firewall check:

8080/tcp                   ALLOW       Anywhere

The listener check should return a LISTEN row containing :8080. If the port isn’t listening, ensure the service is running with systemctl status qbittorrent-nox@$(whoami).

Manage qBittorrent on Ubuntu: Updates and Removal

Update qBittorrent or qBittorrent-nox on Ubuntu

APT provides updates through the stable PPA or Ubuntu’s default repository. Refresh the package lists and upgrade all packages:

sudo apt update && sudo apt upgrade

To upgrade only qBittorrent without touching other packages, use the --only-upgrade flag, which upgrades the named package only if it is already installed:

sudo apt install --only-upgrade qbittorrent

For qBittorrent-nox installations:

sudo apt install --only-upgrade qbittorrent-nox

After updating qBittorrent-nox, restart the service to apply changes:

sudo systemctl restart qbittorrent-nox@$(whoami)

For Flatpak installations, update through the Flatpak toolchain independently of APT:

flatpak update org.qbittorrent.qBittorrent

Remove qBittorrent or qBittorrent-nox from Ubuntu

If you added the stable PPA earlier, remove it before uninstalling. The remove a PPA on Ubuntu guide covers every cleanup method. Ubuntu 26.04 users who installed from the default repository can skip this command.

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

Uninstall the desktop client and remove orphaned dependencies:

sudo apt remove qbittorrent && sudo apt autoremove

For qBittorrent-nox server installations, stop the matching systemd instance before removing the package. Replace $(whoami) with qbittorrent if you used the dedicated service account:

sudo systemctl disable --now qbittorrent-nox@$(whoami)
sudo apt remove qbittorrent-nox && sudo apt autoremove

For Flatpak installations, remove the app and then clean unused Flatpak runtimes:

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

Remove qBittorrent User Data on Ubuntu (Optional)

The following commands permanently delete your qBittorrent configuration, download history, and torrent queue. Back up any data you want to keep before proceeding.

Desktop and regular-user qBittorrent-nox profiles store configuration and data under your home directory. The Flatpak build uses its own sandboxed path:

rm -rf ~/.config/qBittorrent
rm -rf ~/.local/share/qBittorrent
rm -rf ~/.var/app/org.qbittorrent.qBittorrent

If you created the dedicated qbittorrent service account, remove that account’s qBittorrent profile only after confirming no other service uses it:

sudo rm -rf /var/lib/qbittorrent/.config/qBittorrent
sudo rm -rf /var/lib/qbittorrent/.local/share/qBittorrent

Verify APT package removal with installed-state proof:

dpkg -l qbittorrent qbittorrent-nox 2>/dev/null | grep '^ii' || echo "No qBittorrent APT packages are installed"

Expected output after removal:

No qBittorrent APT packages are installed

If you want a secondary PATH check in the same terminal session, clear the shell command cache first:

hash -r
command -v qbittorrent qbittorrent-nox || echo "No qBittorrent commands found in PATH"

Useful qBittorrent Resources and Documentation

• qBittorrent Official Downloads: Upstream release downloads, AppImages, and links to native package options.
• qBittorrent GitHub Repository: Source code, issue tracker, and development discussions.
• qBittorrent Wiki: Detailed documentation, configuration guides, and Web UI API reference.
• qBittorrent Forum: Community discussions, support, and announcement archive.
• qBittorrent on Flathub: Flatpak package with the latest upstream release.
• qBittorrent Team on Launchpad: Ubuntu PPA management and package archives.

Conclusion

You now have qBittorrent installed on Ubuntu with the method that matches your release and update preference. Ubuntu 26.04 users can stay with the default Universe package, while 24.04 and 22.04 users can choose the default package, the stable qBittorrent Team PPA, or the Flathub build. For headless systems, qBittorrent-nox gives Ubuntu Server a systemd-managed Web UI on port 8080. For alternative torrent clients, see the guides on installing Deluge on Ubuntu or installing KTorrent on Ubuntu.