How to Use qBittorrent: The Beginner's Guide (First Install, First Download, Seeding, and the Stalled-Download Fix)
CodexFuse Team · 2026-10-30T09:20:07.589Z · 10 min min read
How to Use qBittorrent: The Beginner's Guide (First Install, First Download, Seeding, and the Stalled-Download Fix)
qBittorrent is a free, open-source BitTorrent client for Windows, macOS, and Linux, and learning how to use qBittorrent takes about ten minutes: install it from its own site, add a .torrent file or magnet link, pick a save folder, and the download starts on its own. It has no ads, no bundled offers, and the same interface on every desktop operating system. This guide walks through the whole first run — install, your first legal download, seeding etiquette, the built-in search and Web UI, and how to fix a download that stalls. One rule governs everything here: BitTorrent is only a delivery method, so this guide covers legal uses only — Linux installers, public-domain books, and other files you have permission to share.
What is qBittorrent, and why do beginners pick it?
qBittorrent is an open-source BitTorrent client — the program that reads .torrent files and magnet links and downloads the files they describe from other people's computers (peers) instead of from one central server. Beginners pick it because it is free with no ads, it looks and works the same on Windows, macOS, and Linux, and it includes power features (a torrent search engine, RSS downloads, and a web interface) without charging for them.
Why it matters: the first-run screen shows a legal notice — when you run a torrent, its data is made available to others by upload, and anything you share is your responsibility. Read that notice before you add your first torrent, because every torrent client uploads while it downloads.
If you move files between your own machines more than you download them, read the FileZilla beginner guide instead — plain file transfer is simpler than a torrent.
How do I install qBittorrent on Windows, macOS, or Linux?
Download qBittorrent only from qbittorrent.org/download (or from your Linux distribution's own package manager), pick the installer for your operating system, and run it — the default settings are correct for beginners. The current version at the time of writing (checked October 30, 2026) is v5.3.0 for Windows and Linux; the macOS build is v5.2.3, and the project's own download page describes the macOS version as "barely supported" because it has no active macOS contributors.
| Operating system | What to install | Notes |
|---|---|---|
| Windows 10 or later | 64-bit installer (v5.3.0) | Pick the standard build; the "lt12" build uses the older libtorrent 1.2 series for older systems |
| macOS 13 or later | DMG (v5.2.3) | Latest build available is 5.2.3; macOS support is limited, so expect fewer updates |
| Ubuntu / Debian | sudo apt-get install qbittorrent, or the official stable PPA for a newer build | The PPA is ppa:qbittorrent-team/qbittorrent-stable |
| Other Linux distros | AppImage from qbittorrent.org, or the distro's own package (sudo pacman -S qbittorrent, emerge net-p2p/qbittorrent, etc.) | The AppImage is built on Ubuntu 22.04 and runs on similarly aged distributions |
On first launch, agree to the legal notice, and the main window opens with an empty torrent list. You do not need to register an account anywhere — there is no account.
How do I add my first torrent or magnet link?
To add your first download, choose File > Add Torrent File… for a .torrent file, or File > Add Torrent Link… to paste a magnet link, then check the save folder and file list in the window that opens and press OK. The difference matters: a .torrent file contains the full file list, trackers, and a checksum for every piece of data; a magnet link is only text — the torrent's infohash plus optional name and tracker — so with a magnet link qBittorrent first shows "Retrieving metadata…" while it fetches the file list from other peers, and nothing downloads until that finishes.
- Open qBittorrent and pick File > Add Torrent File… or File > Add Torrent Link….
- Select the file or paste the magnet link.
- In the options window, check the save folder (default is usually fine).
- Untick any files inside the torrent you don't want — music discs, bonus folders, and similar.
- Press OK. The torrent appears in the list and the download begins.
The first legal download most beginners try is a Linux installer. Legitimate, permission-granted sources include Ubuntu's Alternative downloads page, Debian's official torrents for the stable release, Fedora's torrent directory, Arch Linux's download page (which offers both a magnet link and a .torrent), and the Internet Archive, where many items have a TORRENT link under Download Options with the licence (Public Domain, Creative Commons) shown on the item page. After you try your first Linux download, the Ubuntu beginner guide shows what to do with the ISO.
What do "downloading," "seeding," and "stalled" mean in qBittorrent?
In qBittorrent, "downloading" means fetching file pieces from peers, "seeding" means uploading those pieces back to other people once your download is complete, and "stalled" means no peer currently has the pieces you still need. Seeding is not optional extra credit — it is how the network works, and your client starts seeding automatically at 100%.
The honest rule: BitTorrent itself is legal, but whether a download is legal depends on the file. Copyright exists automatically the moment an original work is fixed, so films, albums, games, books, and paid apps are protected even when nothing on the page says so. Linux installers are copyrighted too — the difference is that their publishers offer the torrents themselves. Because a torrent client also uploads while it downloads, copyright holders' exclusive right to distribute copies is the line that matters; if you don't have permission to share a file, don't download it.
Seeding etiquette: leave a completed torrent running until you have uploaded about as much as you downloaded (a 1:1 ratio), then stop it with Edit > Stop. In qBittorrent 5, the command is called "Stop"; older versions called it "Pause". On very popular torrents the ratio climbs fast; on thin torrents, leave it longer — a few extra days of seeding on a dying Linux ISO helps the next person more than hours on a swarm of thousands.
How do I fix a qBittorrent download that is stuck or stalled?
A stalled qBittorrent download almost always means nobody currently online has the complete pieces you still need — not that your settings are broken — so wait a while, add the torrent's trackers from the source page if you haven't, or find a better-seeded source. Diagnose it with this table before touching any settings:
| What you see | What it usually means | What to do |
|---|---|---|
| Stuck at the same % for hours, seeds listed but no download | No online peer has the missing pieces (dead or dying swarm) | Wait; check the source page for an alternative torrent or magnet with more seeds |
| "Retrieving metadata…" never finishes (magnet link) | No peer with the file list is reachable; the magnet may be stale | Re-copy the magnet from the source, or use the source's .torrent file instead |
| Download crawls at a few KB/s on a well-seeded torrent | Your own bandwidth limits, a saturated home network, or a peer-choking slow connection | Check Tools > Options > Speed for caps you set; pause other big downloads; retry off-peak |
| All torrents stopped or "errored" at once | The save folder moved, the disk is full, or the drive letter changed | Check disk space, re-point the save folder, then Resume |
Two settings are worth changing once before you ever troubleshoot: keep qBittorrent updated (updates fix protocol and security issues), and leave the Web UI remote interface off unless you actually use it — a listening interface you never open is only a risk. Also know that other peers can see your IP address, because trackers hand it out — that is how peer-to-peer works, not a bug.
What are the built-in search, RSS, and Web UI for?
qBittorrent's built-in Search tab (View > Search Engine) searches configured torrent sites from inside the app so you can find and add torrents without a browser; RSS (View > RSS Reader) subscribes to feeds and auto-downloads matching torrents — useful for episode series and nightly builds; and the Web UI lets you control qBittorrent from a browser on another device. These are the features that separate qBittorrent from a bare-bones client, and you can ignore all three for your first month.
To enable the Web UI, open Tools > Options > Web UI, tick "Enable the Web User Interface (Remote control)", set a username and password, and note the port (default 8080). Then browse to http://localhost:8080 on the same machine — the official wiki documents the same address. On a headless Linux box, install qbittorrent-nox (the command-line edition) and the Web UI becomes the whole interface.
For automated, always-on file syncing between your own machines — the job people sometimes try to do with RSS — the Syncthing beginner guide is the better tool; and if you want to reach the Web UI from outside your home network, the Tailscale beginner guide covers secure remote access without opening router ports.
How do I stay safe while downloading torrents?
Stay safe with four habits: get qBittorrent only from its own site and compare the installer's SHA-256 hash with the one published there (qBittorrent publishes SHA-256 checksums for every build), verify the downloaded ISO's own checksum against the publisher's site, read the torrent's file list before it starts, and never run a program from a torrent unless the project publishing it lists that exact file. A torrent's piece checksums only prove you received what the torrent described — for an OS image, the extra check matters, e.g. Get-FileHash .\file.iso in Windows PowerShell or sha256sum file.iso on Linux.
The reason for the first habit: even good projects get hit — in March 2016 the Transmission installers on that project's own site briefly carried ransomware, which is why the checksum comparison is standard advice, not paranoia. And read the file list habit matters because of how often malware hides inside a plausible-looking torrent bundle.
Sources
- qBittorrent official download page, qbittorrent.org/download (read October 30, 2026 — current version v5.3.0 for Windows/Linux, v5.2.3 for macOS, SHA-256 checksums, PPA and distro install commands, macOS "barely supported" note)
- Heatware, "How to Download Torrents with uTorrent or qBittorrent" (updated October 2026, read in full — install steps, File > Add Torrent File/Link, magnet "Retrieving metadata…", stalled-download cause, seeding-to-1:1 rule, Edit > Stop, first-launch upload warning, legal-torrent sources, checksum safety steps)
- Gentoo wiki, "QBittorrent" (read October 30, 2026 — qbittorrent-nox command-line edition, Web UI at localhost:8080, temporary-password behavior, config file path)
Frequently Asked Questions
Is qBittorrent free and safe?
qBittorrent is free and open source with no ads and no bundled software offers, which is the main reason it replaced ad-supported clients for most people. Get it only from qbittorrent.org or your Linux distro's package manager, and compare the installer's SHA-256 hash with the published checksum before running it.
Is qBittorrent legal?
qBittorrent itself is legal — BitTorrent is just a way of moving files. Whether a specific download is legal depends on the file: Linux installers, public-domain books, and Creative Commons works whose publishers offer torrents are the safe examples. The client warns on first launch that running a torrent makes its data available to others, and sharing content you have no right to share is infringement.
Why is my qBittorrent download stuck at 99%?
A download stuck just short of 100% almost always means no currently online peer has those last pieces. Waiting is the fix most of the time; if the torrent is days old and thinly seeded, check the source page for a better-seeded torrent or a direct download instead of changing settings.
Should I stop qBittorrent from seeding?
Seeding is how the network survives, and your client does it automatically. The standard etiquette is to keep seeding until you have uploaded about as much as you downloaded (a 1:1 ratio), then stop the torrent with Edit > Stop. On a torrent with only a handful of seeders, leaving it longer helps more than on a swarm of thousands.
What's the difference between a .torrent file and a magnet link?
A .torrent file contains the file list, tracker list, and per-piece checksums, so qBittorrent can start verifying immediately. A magnet link is just text — the torrent's infohash plus an optional name and tracker — so qBittorrent must first fetch the file list from peers ("Retrieving metadata…") before the download starts. Use whichever the source offers.