How to run qBittorrent on a seedbox you own

Download torrents from your browser — the all-rounder most people should pick. Cresdock runs it on a server you own, from a catalogue, with no Docker and no reverse proxy to configure.

This is Cresdock's suggested starting point in its category — the one to pick if you have no reason to prefer another.

What Cresdock does for you with qBittorrent

Its configuration is written before the container ever starts, so qBittorrent comes up already set up rather than showing you a blank first-run form.
Reached through your panel login. There is no second password to invent for qBittorrent and no port to open on your firewall.
Your Downloads and Media folders are already mounted, and they are the SAME folders your other apps see — so files land where the rest of your setup expects them, with no path mapping to work out.
Because it can fill a disk, it is metered against your storage limit and paused if you run out — instead of silently filling the server.
Single sign-on through your panel login — qBittorrent's own login screen is skipped entirely (its WebUI is only reachable through the proxy, which whitelists itself), so there's no separate qBittorrent password to remember.
Your plan's speed limits and inbound BitTorrent port are seeded directly into its config on install — no manual throttle settings to hunt for.
If you also install cross-seed, it detects qBittorrent automatically and starts cross-seeding without editing a config file.
Install Sonarr, Radarr, Lidarr or Prowlarr and they find qBittorrent by themselves, whichever went first — no download client to add by hand at either end, and the pairing is put back on its own if you ever reset one of them.

Why run qBittorrent yourself

Running a client on your own always-on server means it keeps working when your laptop is shut, on a connection that isn't your home one.

What kind of server qBittorrent needs

Disk is the constraint, not power. A torrent client is happy on a small server; what it needs is somewhere to put the files and a connection that isn't throttled. Cresdock meters what you use and pauses downloading rather than letting a disk fill, so a small server fails safely instead of breaking.

Cresdock itself is undemanding — it runs on a small rented server, an old desktop or a mini PC, on Ubuntu or Debian. Everything it installs shares that machine, so the honest question is not "will this app run" but "how much am I going to put on here in total".

Where to run qBittorrent

qBittorrent runs wherever Cresdock runs, and the choice is about the machine, not the app:

At home, on hardware you already own. A mini PC, an old desktop or a NAS that can run Debian. Cresdock works behind a home router with no port forwarding and no domain, so qBittorrent is reachable on your own network first and from outside only if you choose.
On a rented server. A small VPS is enough for most apps and is the usual answer when qBittorrent should be reachable from anywhere. The setup guide covers the specs and the one-command install.
Through a provider that runs Cresdock. Hosting companies deploy Cresdock workspaces for their customers, so qBittorrent can come with a server you rent rather than one you set up — ask your provider, or see how providers offer it.

Installing qBittorrent

Put Cresdock on a server
One line on any Ubuntu or Debian machine — a rented VPS, a spare PC, a home server. It sets itself up.
Pick qBittorrent from the catalogue
Click Install. The panel pulls the image, writes the configuration, gets a certificate and starts it.
Open it from your dashboard
Its address and any login details are on its card. Start, stop, update, roll back or remove it from the same place, any time.

What this replaces

Doing it by hand means writing something like this, then keeping it working:

services:
  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:5.2.3_v2.0.13-ls469
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - ./qbittorrent/config:/config
      - ./downloads:/downloads
      - ./media:/media

And that is the easy half. Still to do:

Install a reverse proxy and write a server block for it
Get a TLS certificate and set up automatic renewal
Create the folders above with the right ownership, or it will not start
Decide what happens when the disk fills, because nothing here will stop it
Repeat all of it for the next app, and again on every server rebuild

On Cresdock, qBittorrent is one click and none of the above exists.

Common questions

Do I need to know Docker to run qBittorrent?

No. Cresdock installs qBittorrent in one click from its catalogue: it pulls the image, writes the configuration, gets an HTTPS certificate and starts it. qBittorrent's configuration is written before it first starts, so it opens already set up.

What happens to my files when qBittorrent updates?

Cresdock changes qBittorrent's own configuration only. Your downloads and your media are never touched by an update, a rebuild or a reinstall — that is a rule the software enforces, not a promise in a document.

What happens if I run out of space?

Downloading pauses instead of the disk filling up. You keep your files, your other apps keep running, and you get told what happened in plain words.

Can other people on my server see my qBittorrent downloads?

No. Each account's apps run on that account's own private network, and downloads land in that account's own folders — another user's apps cannot reach your qBittorrent, and nobody's files are mixed with anybody else's.

Can I run qBittorrent at home instead of on a VPS?

Yes. Cresdock runs on a mini PC, an old desktop or anything that boots Debian, behind a normal home router with no port forwarding, and qBittorrent is reachable on your own network first. A rented server is only needed when qBittorrent must be reachable from anywhere without a VPN.

Can I remove qBittorrent later?

Yes. Cresdock removes qBittorrent in one click, and asks whether to keep its configuration for a future reinstall. Nothing else you have installed is affected.

Looking for what qBittorrent itself can do? That lives in its own documentation — this page is only about running it.

Pairs well with: ruTorrent · Transmission · File Browser Quantum · how qBittorrent connects to your other apps

Before you start: where to rent a server · what it needs to run · Cresdock vs QuickBox · the seedbox panel in full · sell workspaces to your customers