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.
Note
qi.bash
: The quick installer supports Alpine or Debian like systems.
Latest release using libtorrent v2
bash <(curl -sL https://raw.githubusercontent.com/userdocs/qbittorrent-nox-static/refs/heads/master/qi.bash)
Latest release using libtorrent v1.2
bash <(curl -sL https://raw.githubusercontent.com/userdocs/qbittorrent-nox-static/refs/heads/master/qi.bash) -lt v1
Using Libtorrent v1.2 and forcing the armv7 binary
bash <(curl -sL https://raw.githubusercontent.com/userdocs/qbittorrent-nox-static/refs/heads/master/qi.bash) -lt v1 -fa armv7
Show the help section
bash <(curl -sL https://raw.githubusercontent.com/userdocs/qbittorrent-nox-static/refs/heads/master/qi.bash) -h
You can now run it using this command:
~/bin/qbittorrent
Tip
Access the WebUI at http://localhost:8080
β No installation hassles - Single static binary β Latest versions - Always up-to-date dependencies β Universal compatibility - Runs on any Linux distro β Multiple architectures - Support for ARM devices too
- Overview
- Features
- Installation
- Libtorrent Versions
- Version Management
- Dependency Tracking
- Build Attestation
- Related Projects
- WSL2 Support
- Documentation
The qbittorrent-nox-static
project provides a bash build script that compiles static qbittorrent-nox
binaries using the latest available dependencies from their source. These statically linked binaries offer several advantages:
- Universal compatibility: Run on any Linux distribution with matching CPU architecture
- No dependencies: All required libraries are statically linked
- Latest versions: Built with the most recent stable releases of all dependencies
- Multiple architectures: Support for x86, x86_64, ARM variants
- π§ Static compilation - No external dependencies required
- ποΈ Multi-architecture support - x86, x86_64, armhf, armv7, aarch64
- π¦ Latest dependencies - Always built with current stable versions
- π Automated builds - CI/CD pipeline ensures fresh releases
- π‘οΈ Build attestation - Cryptographically signed provenance
- π Version tracking - JSON metadata for dependency versions
Choose the command that matches your system architecture:
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
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
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
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
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
Important
Libtorrent v1.2 is currently the main branch supported by qBittorrent since the release of 4.4.5. However, both v1.2 and v2.0 builds are provided.
This project automatically builds and releases binaries for both Libtorrent versions:
- Libtorrent v1.2: Stable and widely supported (recommended)
- Libtorrent v2.0: Latest features and improvements
Tip
You can view all current releases and pre-releases at https://github.com/userdocs/qbittorrent-nox-static/tags
Since this project builds both v1.2 and v2.0 simultaneously, you can target specific libtorrent versions using these commands:
jq -r '. | "release-\(.qbittorrent)_v\(.libtorrent_1_2)"' < <(curl -sL https://github.com/userdocs/qbittorrent-nox-static/releases/latest/download/dependency-version.json)
jq -r '. | "release-\(.qbittorrent)_v\(.libtorrent_2_0)"' < <(curl -sL https://github.com/userdocs/qbittorrent-nox-static/releases/latest/download/dependency-version.json)
The build system tracks 5 main dependencies that trigger automatic rebuilds:
- qBittorrent
- Libtorrent
- Qt
- Boost
- OpenSSL
Revision Tracking:
- New releases start at revision
0
- Incremented by
1
for each rebuild - Updates to Qt, Boost, or OpenSSL only update existing release assets
- Updates to qBittorrent or Libtorrent create new releases
jq -r '.revision' < <(curl -sL "https://github.com/userdocs/qbittorrent-nox-static/releases/latest/download/dependency-version.json")
For independent tracking of v1.2 and v2.0 revisions:
-
Get the release tag:
release="$(jq -r '. | "release-\(.qbittorrent)_v\(.libtorrent_1_2)"' < <(curl -sL https://github.com/userdocs/qbittorrent-nox-static/releases/latest/download/dependency-version.json))"
-
Get the revision for that release:
jq -r '.revision' < <(curl -sL "https://github.com/userdocs/qbittorrent-nox-static/releases/download/${release}/dependency-version.json")
Each release includes a dependency-version.json
file that provides version information shared across latest and pre-releases. This helps overcome API limitations for consistent access to version data.
curl -sL https://github.com/userdocs/qbittorrent-nox-static/releases/latest/download/dependency-version.json
{
"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"
}
Important
Starting with qBittorrent v5, configure-based builds will be unsupported. Only CMake builds will be available, with Qt6 as the default. Qt5 builds will be considered legacy and eventually dropped.
Binaries built from release-5.0.0_v2.0.10
and release-5.0.0_v1.2.19
revision 1
onwards use actions/attest-build-provenance for cryptographic verification.
You can verify the integrity and provenance of downloaded binaries using GitHub CLI:
gh attestation verify x86_64-qbittorrent-nox -o userdocs
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
For more information, visit the GitHub CLI attestation documentation.
This build script depends on several related repositories:
- qbt-musl-cross-make - Cross-compilation toolchain
- qbt-workflow-files - CI/CD workflow templates
- qbt-ninja-build - Ninja build system integration
- qbt-host-deps - Host dependency management
- qbt-cmake-ninja-crossbuilds - CMake cross-build configurations
Tip
These static builds work perfectly on WSL2! After installation, access the WebUI at localhost:8080
from your Windows browser.
The static nature of these builds makes them ideal for WSL2 environments where dependency management can be challenging.
Tip
For comprehensive documentation, visit the project documentation which covers:
- Detailed build instructions
- Advanced configuration options
- Troubleshooting guides
- Contributing guidelines