qbittorrent

5.3.0_v2.1.2-ls484

The qbittorrent is a bittorrent client programmed in C++ / Qt that uses libtorrent (sometimes called libtorrent-rasterbar) by Arvid Norberg.

Downloaders

docker pull lscr.io/linuxserver/qbittorrent:latest

Quick start

Generated from the image's own configuration. Replace the /path/to folders with real paths on your host.

Include optional settings

---
services:
  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    container_name: qbittorrent
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - WEBUI_PORT=8080
      - TORRENTING_PORT=6881
    volumes:
      - /path/to/qbittorrent/appdata:/config
      - /path/to/downloads:/downloads # optional
    ports:
      - 8080:8080
      - 6881:6881
      - 6881:6881/udp
    stop_grace_period: 10s # optional
    restart: unless-stopped

Parameters

Ports
Port	Function	Required
8080:8080	WebUI	required
6881:6881	tcp connection port	required
6881:6881/udp	udp connection port	required

Environment variables
Variable	Function	Required
PUID=1000	User ID	required
PGID=1000	Group ID	required
TZ=Etc/UTC	Timezone	required
WEBUI_PORT=8080	for changing the port of the web UI, see below for explanation	required
TORRENTING_PORT=6881	for changing the port of tcp/udp connection, see below for explanation	required

Volumes
Path	Function	Required
/config	Contains all relevant configuration files.	required
/downloads	Location of downloads on disk.	optional

Other settings
Setting	Function	Required
stop_grace_period: 10s	If you have a large number of torrents you may need to increase the container stop timeout to ensure a clean shutdown.	optional

Architectures

Pulling :latest picks the right one for your host automatically.

x86_64amd64-latest
arm64arm64v8-latest

Changelog

5 Jul 2026
Rebase to Alpine 3.24.
4 May 2026
Switch to static builds for parity with libtorrentv1 branch. Rebase to Alpine 3.23.
17 Jul 2024
Restore qbittorrent-cli as it now supports openssl 3.

Browse all

sabnzbd

5.1.3-ls278

sabnzbd makes Usenet as simple and streamlined as possible by automating everything we can. All you have to do is add an .nzb. SABnzbd takes over from there, where it will be automatically downloaded, verified, repaired, extracted and filed away with zero human interaction.

7.9M366arm64

transmission

4.1.3-r0-ls365

transmission is designed for easy, powerful use. Transmission has the features you want from a BitTorrent client: encryption, a web interface, peer exchange, magnet links, DHT, µTP, UPnP and NAT-PMP port forwarding, webseed support, watch directories, tracker editing, global and per-torrent speed limits, and more.

2.1M742arm64

nzbget

v26.3-ls268

nzbget is a usenet downloader, written in C++ and designed with performance in mind to achieve maximum download speed by using very little system resources.

1.1M192arm64

deluge

2.2.0-ls384

deluge is a lightweight, Free Software, cross-platform BitTorrent client. * Full Encryption * WebUI * Plugin System * Much more...

714K296arm64