How to Install qBittorrent on Fedora Linux

Fedora already packages both the qBittorrent BitTorrent desktop client and the headless qbittorrent-nox service, so you can install qBittorrent on Fedora without chasing third-party RPM downloads. The desktop build fits Workstation sessions when you want to handle torrents locally, while the Web UI service is better for always-on hosts that you manage from a browser.

Updates stay inside DNF, and cleanup stays simpler because neither build needs a separate repository. The desktop package still needs an active graphical session to launch, while qbittorrent-nox is built for remote management. If you only need a lighter BitTorrent client, install Transmission on Fedora instead.

Install qBittorrent on Fedora

Fedora’s default repositories include both qBittorrent packages, so the main decision is whether you want the desktop client or the headless Web UI service.

Update Fedora System Packages Before Installing qBittorrent

Start from a current package set before installing either build.

sudo dnf upgrade --refresh

These commands use sudo for system changes. If your account is not in the sudoers file yet, follow the guide to add a user to sudoers on Fedora before continuing.

Compare qBittorrent Desktop and qbittorrent-nox

Choose the build that matches where the torrents will run.

Build	Package	Best For	What You Get
qBittorrent Desktop	qbittorrent	Fedora Workstation or any desktop session where you want to manage torrents locally	Qt desktop client, Activities launcher, and the usual qbittorrent command
qbittorrent-nox	qbittorrent-nox	Fedora Server, seedboxes, or remote systems where you want browser-based control	Headless daemon, packaged qbittorrent-nox@.service, and a Web UI on port 8080

Use the desktop package when you sit at the Fedora machine. Use qbittorrent-nox when the box stays online in the background and you want to manage it from another device.

Install qBittorrent Desktop Client

The desktop package is the straightforward choice for local Fedora sessions.

sudo dnf install qbittorrent

Confirm that Fedora registered the package after the install finishes.

rpm -q qbittorrent

qbittorrent-5.1.4-1.fc43.x86_64

Install qBittorrent-nox Package

The headless package is the better fit when you plan to manage downloads through the Web UI instead of a local desktop window.

sudo dnf install qbittorrent-nox

Use Fedora’s package database to confirm the installed build before you configure the service.

rpm -q qbittorrent-nox

qbittorrent-nox-5.1.4-1.fc43.x86_64

Launch qBittorrent Desktop on Fedora

The desktop package installs the qbittorrent launcher and a Fedora Activities entry named qBittorrent.

qbittorrent

Search for qBittorrent in Activities if you prefer the graphical launcher. The package installs a desktop file named org.qbittorrent.qBittorrent.desktop, but Fedora shows the app simply as qBittorrent.

The first launch opens qBittorrent’s legal notice. Accept it once, then the main window is ready for normal torrent management, RSS feeds, and search plugins.

Configure qBittorrent-nox on Fedora

Fedora 43 ships the packaged qbittorrent-nox@.service template, so the job here is preparing a dedicated service account and bootstrapping the first run cleanly.

Create the qBittorrent-nox Service Account

Create a dedicated system group and a non-interactive service user with /var/lib/qbittorrent as its home directory.

sudo groupadd --system qbittorrent-nox
sudo useradd --system --create-home --home-dir /var/lib/qbittorrent --shell /usr/sbin/nologin -g qbittorrent-nox qbittorrent-nox

Create qBittorrent Download Directory

Fedora writes the qBittorrent service config under /var/lib/qbittorrent/.config/qBittorrent/ after the first start. Create a dedicated download path now so the daemon has a clean service-owned location for completed files.

sudo mkdir -p /var/lib/qbittorrent/downloads
sudo chown -R qbittorrent-nox:qbittorrent-nox /var/lib/qbittorrent

Verify that the service home and download directory belong to the dedicated account before you start the daemon.

sudo ls -ld /var/lib/qbittorrent /var/lib/qbittorrent/downloads

drwx------. 1 qbittorrent-nox qbittorrent-nox 98 Mar 27 14:36 /var/lib/qbittorrent
drwxr-xr-x. 1 qbittorrent-nox qbittorrent-nox  0 Mar 27 14:36 /var/lib/qbittorrent/downloads

Accept the qBittorrent Legal Notice

Fedora 43 supports --confirm-legal-notice, so you do not need to sit at an interactive prompt and press y. The timeout 8s wrapper lets qBittorrent write its first-run files, print the temporary Web UI password, and then stop cleanly.

sudo -u qbittorrent-nox timeout 8s /usr/bin/qbittorrent-nox --confirm-legal-notice --webui-port=8080

Relevant output includes the Web UI address and the one-time temporary password for this session.

WebUI will be started shortly after internal preparations. Please wait...

******** Information ********
To control qBittorrent, access the WebUI at: http://localhost:8080
The WebUI administrator username is: admin
The WebUI administrator password was not set. A temporary password is provided for this session: Mfh6fr5HH
You should set your own password in program preferences.

Start the qBittorrent-nox Systemd Service

Fedora’s packaged unit starts the daemon as the user named after the @ symbol, so the dedicated account you created earlier drops straight into the supported service template.

sudo systemctl enable --now qbittorrent-nox@qbittorrent-nox.service

Use systemd’s enabled and active states as the quick health check before you open the Web UI.

systemctl is-enabled qbittorrent-nox@qbittorrent-nox.service
systemctl is-active qbittorrent-nox@qbittorrent-nox.service

enabled
active

Sign In to the qBittorrent Web UI

Open http://server-ip-address:8080 in a browser on the same network. If this Fedora host is exposed beyond localhost, use the guide to install Firewalld on Fedora or keep port 8080 restricted to trusted networks only.

The journal keeps the current startup password, and this command uses the grep command in Linux with examples to isolate the credential lines before showing the newest username and password pair.

sudo journalctl -u qbittorrent-nox@qbittorrent-nox.service -n 30 --no-pager | grep -Ei "administrator username|temporary password" | tail -n 2

Mar 27 14:32:21 fedora qbittorrent-nox[15403]: The WebUI administrator username is: admin
Mar 27 14:32:21 fedora qbittorrent-nox[15403]: The WebUI administrator password was not set. A temporary password is provided for this session: dtBtHEk6N

Sign in with the username admin and the temporary password from the journal, then store your own credentials under Tools > Options > Web UI > Authentication. Restart the daemon once you save the new username and password so the hashed credentials reload cleanly.

sudo systemctl restart qbittorrent-nox@qbittorrent-nox.service

Manage qBittorrent on Fedora

Once qBittorrent is in place, regular maintenance is mostly standard DNF work plus a little extra cleanup for the headless service account.

Update qBittorrent on Fedora

DNF updates both qBittorrent packages through the normal Fedora refresh cycle.

sudo dnf upgrade --refresh

When you move to the next Fedora release, use the guide to run the DNF5 system upgrade command on Fedora so qBittorrent and its dependencies move forward together.

Remove qBittorrent Desktop on Fedora

Removing the desktop package is just a normal DNF erase operation.

sudo dnf remove qbittorrent

Check Fedora’s package database afterward instead of relying on the launcher disappearing from Activities.

rpm -q qbittorrent

package qbittorrent is not installed

If you launched the GUI before removing it, search for per-user leftovers first. No output means the desktop profile directories are already gone.

find "$HOME" -maxdepth 3 \( -path "$HOME/.config/qBittorrent" -o -path "$HOME/.local/share/qBittorrent" -o -path "$HOME/.cache/qBittorrent" \)

If the command prints any of those directories and you no longer need the saved desktop profile, remove them with:

rm -rf "$HOME/.config/qBittorrent" "$HOME/.local/share/qBittorrent" "$HOME/.cache/qBittorrent"

Remove qBittorrent-nox on Fedora

Remove the service in stages so systemd stops cleanly before you erase the package and service account.

sudo systemctl disable --now qbittorrent-nox@qbittorrent-nox.service
sudo dnf remove qbittorrent-nox
sudo userdel qbittorrent-nox

Fedora usually removes the matching private group when you delete the user. If getent group qbittorrent-nox still prints a line afterward, remove the leftover group explicitly.

sudo groupdel qbittorrent-nox

Deleting /var/lib/qbittorrent removes the service configuration in .config/qBittorrent, runtime data in .local/share/qBittorrent, cache files, GeoIP data, and anything left in downloads. Back up anything you want to keep before you erase that directory.

sudo rm -rf /var/lib/qbittorrent

Verify both the package removal and the service home cleanup before you call the job done.

rpm -q qbittorrent-nox
sudo test ! -e /var/lib/qbittorrent && echo removed

package qbittorrent-nox is not installed
removed

Troubleshoot qBittorrent-nox on Fedora

Most qbittorrent-nox problems on Fedora come down to first-run setup, firewall access, ownership drift, or SELinux labels.

Fix qBittorrent-nox Service Startup Failures

Start with the unit status so you can tell whether qBittorrent failed on its first run or during a later restart.

sudo systemctl status qbittorrent-nox@qbittorrent-nox.service --no-pager -n 20

qbittorrent-nox@qbittorrent-nox.service: Main process exited, code=exited, status=1/FAILURE
qbittorrent-nox@qbittorrent-nox.service: Failed with result 'exit-code'.

If the service never completed the legal notice step, bootstrap it again and then restart the unit.

sudo -u qbittorrent-nox timeout 8s /usr/bin/qbittorrent-nox --confirm-legal-notice --webui-port=8080
sudo systemctl restart qbittorrent-nox@qbittorrent-nox.service
systemctl is-active qbittorrent-nox@qbittorrent-nox.service

active

Fix Remote qBittorrent Web UI Access on Fedora

Confirm the daemon is listening locally before you change firewall rules.

sudo ss -ltnp | grep 8080

LISTEN 0      50                                                    *:8080             *:*    users:(("qbittorrent-nox",pid=15713,fd=40))

If that listener exists but remote browsers still cannot connect, check whether firewalld is blocking port 8080.

sudo firewall-cmd --query-port=8080/tcp

A response of no means firewalld still blocks the port. Open it for testing, then make the rule persistent.

sudo firewall-cmd --add-port=8080/tcp
sudo firewall-cmd --add-port=8080/tcp --permanent
sudo firewall-cmd --reload
sudo firewall-cmd --query-port=8080/tcp

yes

Fix qBittorrent File-Permission Errors

The service account must own both its home directory and the download path.

sudo ls -ld /var/lib/qbittorrent /var/lib/qbittorrent/downloads

drwx------. 1 qbittorrent-nox qbittorrent-nox 98 Mar 27 14:36 /var/lib/qbittorrent
drwxr-xr-x. 1 qbittorrent-nox qbittorrent-nox  0 Mar 27 14:36 /var/lib/qbittorrent/downloads

If ownership drifted after a manual copy or restore, reset it and restart the daemon.

sudo chown -R qbittorrent-nox:qbittorrent-nox /var/lib/qbittorrent
sudo systemctl restart qbittorrent-nox@qbittorrent-nox.service

Check SELinux Denials for qBittorrent

Fedora 43 ships ausearch through the audit package by default, but stripped-down installs may need that package first. Search recent AVC messages before you start changing labels.

sudo ausearch -m avc -ts recent | grep qbittorrent

No output means there were no recent qBittorrent-specific AVC denials. If denials appear after moving or restoring the data tree, reset Fedora’s default labels on that path.

sudo restorecon -Rv /var/lib/qbittorrent

qBittorrent on Fedora FAQ

Conclusion

qBittorrent is running on Fedora as either a desktop client or a Web UI service, so you can keep downloads local or move them onto a dedicated host without leaving Fedora’s repositories. If you want a lighter client, install Transmission on Fedora, and if the Web UI needs network exposure, install Firewalld on Fedora before you open port 8080 more broadly.