Public Repository

Last pushed: 3 months ago
Short Description
qbittorrent-nox for aarch64
Full Description

docker-qbittorrent for AArch64

This is a Docker image for running qBittorrent on AArch64. It is adapted from wernight's Alpine-based x86 image. Below is a slightly modified extract of the original project's readme.

About qbittorrent-nox

qBittorrent NoX is the headless with remote web interface version of qBittorrent BitTorrent client.

This image is:

  • Small: Based on an Alpine Linux Docker image.
  • Simple: Exposes correct ports, configured for remote access.
  • Secure: Runs as non-root user with random UID/GID 520.

Note that Docker Hub currently does not support automated build for non-x86 platforms. You are encouraged to examine the Dockerfile for this image on GItHub and build it on your own AArch64 machine.


Obtaining the image

You can download the image from the Docker Hub:

$ docker pull andreipoe/qbittorrent-aarch64

Alternatively, you can clone the GitHub repository and build the image locally:

$ git clone
$ cd docker-qbittorrent-aarch64
$ docker build -t qbittorrent-aarch64 . 

Running the image

All mounts and ports are optional and qBittorrent will work even with only:

$ docker run andreipoe/qbittorrent-aarch64

... however that way some ports used to connect to peers are not exposed, accessing the
web interface requires you to proxy port 8080, and all settings as well as downloads will
be lost if the container is removed.

So let's create some directories as user 520 (qbittorrent):

$ mkdir config torrents downloads
$ chown 520 config torrents downloads

... and start using this command:

$ docker run -d \
    -p 8080:8080 -p 6881:6881/tcp -p 6881:6881/udp \
    -v $PWD/config:/config \
    -v $PWD/torrents:/torrents \
    -v $PWD/downloads:/downloads \

... to have webUI running on http://localhost:8080 (username: admin, password: adminadmin) with config in the following locations mounted:

  • /config: qBittorrent configuration files
  • /torrents: Torrent files
  • /downloads: Download location

It is probably a good idea to add --restart=unless-stopped so the container restarts if it goes down.

You can change 6081 to some random port number (also change in the settings). However, note that as of version 4.0, you have to use the same Web UI port on the host and inside the container, otherwise you will only see a white page.

Note: For the container to run, the legal notice had to be automatically accepted. By running the container, you are accepting its terms. Toggle the flag in qBittorrent.conf to display the notice again.

Note: 520 was chosen randomly to prevent running as root or as another known user on your system; at least until issue #11253 is fixed.

Docker Pull Command