qBittorrent-nox Static Builds

Cross-platform static builds of qBittorrent-nox with the latest dependencies.

Latest Release | Documentation | All Releases

Tip

Docker: Use https://hotio.dev/containers/qbittorrent — Libtorrent v1.2 and v2 static builds combined into a single docker image with VPN support.

Overview

A bash build script that compiles fully static qbittorrent-nox binaries using the latest source releases of all dependencies. Static binaries run on any Linux distribution with a matching CPU architecture — no external libraries required.

Supported architectures: x86 x86_64 armhf armv7 aarch64 s390x powerpc ppc64el mips mipsel mips64 mips64el riscv64 loongarch64

Quick Install

Note

The quick installer qi.bash supports Alpine and Debian-based systems.

# Latest release (libtorrent v2)
bash <(curl -sL usrdx.github.io/s/qi.bash)

# Latest release (libtorrent v1.2)
bash <(curl -sL usrdx.github.io/s/qi.bash) -lt v1

# Force a specific architecture
bash <(curl -sL usrdx.github.io/s/qi.bash) -lt v1 -fa armv7

# Show help
bash <(curl -sL usrdx.github.io/s/qi.bash) -h

Tip

Access the WebUI at http://localhost:8080

Manual Install

Download commands per architecture

x86_64

mkdir -p ~/bin && source ~/.profile
wget -qO ~/bin/qbittorrent-nox https://github.com/userdocs/qbittorrent-nox-static/releases/latest/download/x86_64-qbittorrent-nox
chmod 700 ~/bin/qbittorrent-nox

aarch64

mkdir -p ~/bin && source ~/.profile
wget -qO ~/bin/qbittorrent-nox https://github.com/userdocs/qbittorrent-nox-static/releases/latest/download/aarch64-qbittorrent-nox
chmod 700 ~/bin/qbittorrent-nox

armv7

mkdir -p ~/bin && source ~/.profile
wget -qO ~/bin/qbittorrent-nox https://github.com/userdocs/qbittorrent-nox-static/releases/latest/download/armv7-qbittorrent-nox
chmod 700 ~/bin/qbittorrent-nox

armhf

mkdir -p ~/bin && source ~/.profile
wget -qO ~/bin/qbittorrent-nox https://github.com/userdocs/qbittorrent-nox-static/releases/latest/download/armhf-qbittorrent-nox
chmod 700 ~/bin/qbittorrent-nox

x86

mkdir -p ~/bin && source ~/.profile
wget -qO ~/bin/qbittorrent-nox https://github.com/userdocs/qbittorrent-nox-static/releases/latest/download/x86-qbittorrent-nox
chmod 700 ~/bin/qbittorrent-nox

Libtorrent Versions

Both Libtorrent v1.2 (stable) and v2.0 (latest features) builds are provided with every release.

Important

Libtorrent v1.2 is the main branch supported by qBittorrent since 4.4.5.

Version Management

Each release includes dependency-version.json with version metadata for all dependencies.

curl -sL https://github.com/userdocs/qbittorrent-nox-static/releases/latest/download/dependency-version.json

Example output

{
    "openssl": "3.2.0",
    "boost": "1.84.0",
    "libtorrent_1_2": "1.2.19",
    "libtorrent_2_0": "2.0.9",
    "qt5": "5.15.12",
    "qt6": "6.6.1",
    "qbittorrent": "4.6.2",
    "revision": "3"
}

Release Tags

Get the release tag for a specific libtorrent version:

# Libtorrent v1.2
jq -r '. | "release-\(.qbittorrent)_v\(.libtorrent_1_2)"' < <(curl -sL https://github.com/userdocs/qbittorrent-nox-static/releases/latest/download/dependency-version.json)

# Libtorrent v2.0
jq -r '. | "release-\(.qbittorrent)_v\(.libtorrent_2_0)"' < <(curl -sL https://github.com/userdocs/qbittorrent-nox-static/releases/latest/download/dependency-version.json)

Build Revisions

Five dependencies trigger automatic rebuilds: qBittorrent, Libtorrent, Qt, Boost, and OpenSSL.

• Updates to qBittorrent or Libtorrent create new releases starting at revision 0
• Updates to Qt, Boost, or OpenSSL update existing release assets and increment the revision

# Check latest revision
jq -r '.revision' < <(curl -sL "https://github.com/userdocs/qbittorrent-nox-static/releases/latest/download/dependency-version.json")

Important

Starting with qBittorrent v5, only CMake builds are supported with Qt6 as the default. Qt5 builds are considered legacy.

Build Attestation

Binaries from release-5.0.0_v2.0.10 / release-5.0.0_v1.2.19 revision 1 onwards use actions/attest-build-provenance for cryptographic verification.

gh attestation verify x86_64-qbittorrent-nox -o userdocs

Example verification output

Loaded digest sha256:a656ff57b03ee6218205d858679ea189246caaecbbcc38d4d2b57eb81d8e59bb for file://x86_64-qbittorrent-nox
Loaded 1 attestation from GitHub API
✓ Verification succeeded!

sha256:a656ff57b03ee6218205d858679ea189246caaecbbcc38d4d2b57eb81d8e59bb was attested by:
REPO                             PREDICATE_TYPE                  WORKFLOW
userdocs/qbittorrent-nox-static  https://slsa.dev/provenance/v1  .github/workflows/matrix_multi_build_and_release_qbt_workflow_files.yml@refs/heads/master

Related Projects

• qbt-musl-cross-make — Cross-compilation toolchain
• qbt-workflow-files — CI/CD workflow templates
• qbt-host-deps — Host dependency management

Documentation

For build instructions, advanced configuration, and troubleshooting, visit the project documentation.

Tip

These static binaries work on WSL2 — access the WebUI at localhost:8080 from your Windows browser.