fp/apps/qbittorrent-nox/README.md
CJ_Clippy c3da9e26bc
Some checks failed
ci / build (push) Failing after 12m34s
ci / test (push) Failing after 8m11s
add qbittorrent-nox docker image
2025-09-08 02:56:37 -08:00

1.4 KiB

qbittorrent-nox

headless qBittorrent.

We build our own docker container because the official version uses libtorrent 1. We need libtorrent 2 which provides support for creating hybrid torrents.

See https://github.com/qbittorrent/docker-qbittorrent-nox/tree/main/manual_build

Configuration

Environment Variables

QBT_USERNAME

  • Type: string
  • Default: unset
  • Description: Username for qBittorrent WebUI. Must be set together with QBT_PASSWORD.

QBT_PASSWORD

  • Type: string
  • Default: unset
  • Description: Password for qBittorrent WebUI. Must be set together with QBT_USERNAME.
    Generates a PBKDF2-HMAC-SHA512 hash with a random 16-byte salt automatically.
  • Type: string
  • Default: unset
  • Description: Must be set to confirm to automatically accept the qBittorrent legal notice.

QBT_WEBUI_PORT

  • Type: integer
  • Default: 8080
  • Description: Overrides the default WebUI port.

QBT_TORRENTING_PORT

  • Type: integer
  • Default: 6881
  • Description: Overrides the default torrenting port for incoming torrent connections.

QBT_DISABLE_NETWORK

  • Type: boolean (any non-empty value)
  • Default: unset
  • Description: If set, disables all peer-to-peer networking features (DHT, LSD, PEX, uploads/downloads, max connections), effectively running qBittorrent in “WebUI only” mode.