qBittorrent/dist/docker

qBittorrent-nox Docker Image

This Dockerfile allows you to build a docker image containing qBittorrent-nox

Prerequisites

In order to build/run this image you'll need docker installed: https://docs.docker.com/get-docker/

It is also recommended to install docker-compose as it can significantly ease the process: https://docs.docker.com/compose/install/

Building docker image

• If you are using docker (not docker-compose) then run the following commands in this folder:

  export \
    QBT_VERSION=devel
  docker build \
    --build-arg QBT_VERSION \
    -t qbittorrent-nox:"$QBT_VERSION" \
    .
  

• If you are using docker-compose then you should edit .env file first. You can find an explanation of the variables in the following Parameters section.
  Then run the following commands in this folder:

  docker compose build \
    --build-arg QBT_VERSION
  

Parameters

Environment variables

• QBT_EULA
  This environment variable defines whether you accept the end-user license agreement (EULA) of qBittorrent.
  Put accept only if you understand and accepted the EULA. You can find the EULA here.
• QBT_VERSION
  This environment variable specifies the version of qBittorrent-nox to be built.
  For example, 4.4.0 is a valid entry. You can find all tagged versions here.
  Or you can put devel to build the latest development version.
• QBT_WEBUI_PORT
  This environment variable sets the port number which qBittorrent WebUI will be binded to.

Volumes

There are some paths involved:

• <your_path>/config on your host machine will contain qBittorrent configurations
• <your_path>/downloads on your host machine will contain the files downloaded by qBittorrent

Running container

• Using docker (not docker-compose), simply run:

  export \
    QBT_EULA=accept \
    QBT_VERSION=devel \
    QBT_WEBUI_PORT=8080 \
    QBT_CONFIG_PATH="/tmp/bbb/config"
    QBT_DOWNLOADS_PATH="/tmp/bbb/downloads"
  docker run \
    -t \
    --read-only \
    --rm \
    --tmpfs /tmp \
    --name qbittorrent-nox \
    -e QBT_EULA \
    -e QBT_WEBUI_PORT \
    -p "$QBT_WEBUI_PORT":"$QBT_WEBUI_PORT"/tcp \
    -p 6881:6881/tcp \
    -p 6881:6881/udp \
    -v "$QBT_CONFIG_PATH":/config \
    -v "$QBT_DOWNLOADS_PATH":/downloads \
    qbittorrent-nox:"$QBT_VERSION"
  

• Using docker-compose:

  docker compose up
  

Then you can login at: http://127.0.0.1:8080

Stopping container

• Using docker (not docker-compose):

  docker stop -t 1800 qbittorrent-nox
  

• Using docker-compose:

  docker compose down