docker-qbittorrent

Docker image for qBittorrent.

• Tiny size
• Enable rootless[^1]
• Enable QBT_* options[^2]
• Keep updating
• Compile by clang

Usage

Pull this image:

docker pull ghcr.io/mogeko/qbittorrent

Run with docker cli:

docker run -d \
  --name qbittorrent \
  --user 1000:100 `#optional` \
  -e QBT_WEBUI_PORT=8080 \
  -p 6881:6881 \
  -p 6881:6881/udp \
  -p 8080:8080 \
  -v /path/to/config:/config \
  -v /path/to/downloads:/downloads \
  --restart unless-stopped \
  ghcr.io/mogeko/qbittorrent

Run with docker-compose:

---
version: 2.1
services:
  qbittorrent:
    image: ghcr.io/mogeko/qbittorrent
    container_name: qbittorrent
    user: 1000:100 #optional
    environment:
      - QBT_WEBUI_PORT=8080
    volumes:
      - /path/to/config:/config
      - /path/to/downloads:/downloads
    ports:
      - 6881:6881
      - 6881:6881/udp
      - 8080:8080
    restart: unless-stopped

Parameters

Container images are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate <external>:<internal> respectively. For example, -p 8080:80 would expose port 80 from inside the container to be accessible from the host's IP on port 8080 outside the container.

The qbittorrent-nox's options may be supplied via environment variables[^2]. For option named 'parameter-name', environment variable name is QBT_PARAMETER_NAME (in uppercase, - replaced with _). To pass flag values, set the variable to 1 or TRUE. Here is an example we already in used: -e QBT_WEBUI_PORT=8080.

More help message about qbittorrent-nox, you can get via:

docker run -it ghcr.io/mogeko/qbittorrent --help

License

The code in this project is released under the GPL-3.0 License.

[^1]: This image should be able to work with podman, but it has not been tested. [^2]: The option QBT_PROFILE does not support.