Fork of mogeko's image since it hasn't been maintained in a few years
Find a file
2021-11-16 19:35:43 +00:00
.devcontainer build(ci): test the image compilation 2021-11-15 17:33:32 +00:00
.github build(ci): set cron time with 23:30 (UTC) 2021-11-15 23:52:31 +00:00
root feat: run qbittorrent-nox with a script 2021-11-16 18:37:29 +00:00
.gitattributes build: exclude .devcontainer/*from git language statistics 2021-11-16 19:35:43 +00:00
.gitignore build: init development environment 2021-11-11 18:05:55 +00:00
Dockerfile feat: run qbittorrent-nox with a script 2021-11-16 18:37:29 +00:00
LICENSE Initial commit 2021-11-11 18:52:08 +01:00
README.md docs: enable configuration files 2021-11-16 19:02:16 +00:00

docker-qbittorrent

ci_icon

Docker image for qBittorrent.

  • Tiny size
  • Enable rootless1
  • Enable QBT_* options2
  • Keep updating

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.

Parameter Function
-p 6881 tcp connection port
-p 6881/udp udp connection port
-p 8080 The Web UI port
-e QBT_WEBUI_PORT=8080 Change the Web UI port
-v /config Save the configuration files
-v /downloads Location of downloads on disk

The qbittorrent-nox's options may be supplied via environment variables2. 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. ↩︎