Welcome to Docker qBittorrent

The qBittorrent project aspires to offer an open-source alternative to µTorrent software. A distinguishing feature of qBittorrent is its web user interface (UI), which allows you to manage your torrents from your server or Raspberry Pi.

Moreover, qBittorrent operates and offers identical functionalities across all key platforms, including Linux, macOS, Windows, OS/2, and FreeBSD.

qBittorrent's foundation lies in the Qt toolkit and the libtorrent-rasterbar library.

What Inspired This Project?

Initially, I aimed to operate qBittorrent on my Raspberry Pi through Docker, but this was nonexistent. Consequently, I decided to construct this image, optimized with Linux Alpine and occupying less than 35 MB.

Support for Multiple Architectures

Please note that version 4.4.x does not provide support for armv7 anymore.

• armv8 (arm64)
• amd64 (x86_64)

Download / Update

docker pull maltyxx/qbittorrent:latest

How to Use

Container Variables

There's one crucial variable needed to run the container:

• The LEGAL variable signifies whether you agree with the Legal Notice. Input 'accept' as a value only if you comprehend and agree with the Legal Notice.

Volumes

Two main locations exist:

• downloads holds the files downloaded by qBittorrent
• config houses qBittorrent configurations

By default, it operates as UID 1000 and GID 1000, but it can operate as any user/group.

Network

The web interface operates on port 8080.

RUN

docker run \
--name qBittorrent \
--env LEGAL=accept \
-p 8080:8080/tcp \
-v <volume_config>:/config \
-v <volume_download>:/downloads \
maltyxx/qbittorrent:latest

WebUI

Log into the interface at http://localhost:8080.

Modify your login credentials:

• user: admin
• password: adminadmin