linuxserver/qbittorrent¶
The Qbittorrent project aims to provide an open-source software alternative to µTorrent. qBittorrent is based on the Qt toolkit and libtorrent-rasterbar library.
Supported Architectures¶
We utilise the docker manifest for multi-platform awareness. More information is available from docker here and our announcement here.
Simply pulling lscr.io/linuxserver/qbittorrent:latest should retrieve the correct image for your arch, but you can also pull specific arch images via tags.
The architectures supported by this image are:
| Architecture | Available | Tag |
|---|---|---|
| x86-64 | ✅ | amd64-<version tag> |
| arm64 | ✅ | arm64v8-<version tag> |
| armhf | ❌ |
Version Tags¶
This image provides various versions that are available via tags. Please read the descriptions carefully and exercise caution when using unstable or development tags.
| Tag | Available | Description |
|---|---|---|
| latest | ✅ | Stable qbittorrent releases |
| libtorrentv1 | ✅ | Static qbittorrent builds using libtorrent v1 |
Application Setup¶
The webui is at <your-ip>:8080 and the default username/password is admin/adminadmin.
Change username/password via the webui in the webui section of settings.
WEBUI_PORT variable¶
Due to issues with CSRF and port mapping, should you require to alter the port for the webui you need to change both sides of the -p 8080 switch AND set the WEBUI_PORT variable to the new port.
For example, to set the port to 8090 you need to set -p 8090:8090 and -e WEBUI_PORT=8090
This should alleviate the "white screen" issue.
If you have no webui , check the file /config/qBittorrent/qBittorrent.conf
edit or add the following lines
WebUI\Address=*
+ qbittorrent - LinuxServer.io linuxserver/qbittorrent¶
The Qbittorrent project aims to provide an open-source software alternative to µTorrent. qBittorrent is based on the Qt toolkit and libtorrent-rasterbar library.
Supported Architectures¶
We utilise the docker manifest for multi-platform awareness. More information is available from docker here and our announcement here.
Simply pulling lscr.io/linuxserver/qbittorrent:latest should retrieve the correct image for your arch, but you can also pull specific arch images via tags.
The architectures supported by this image are:
Architecture Available Tag x86-64 ✅ amd64-<version tag> arm64 ✅ arm64v8-<version tag> armhf ❌
Version Tags¶
This image provides various versions that are available via tags. Please read the descriptions carefully and exercise caution when using unstable or development tags.
Tag Available Description latest ✅ Stable qbittorrent releases libtorrentv1 ✅ Static qbittorrent builds using libtorrent v1
Application Setup¶
The webui is at <your-ip>:8080 and the default username/password is admin/adminadmin.
Change username/password via the webui in the webui section of settings.
WEBUI_PORT variable¶
Due to issues with CSRF and port mapping, should you require to alter the port for the webui you need to change both sides of the -p 8080 switch AND set the WEBUI_PORT variable to the new port.
For example, to set the port to 8090 you need to set -p 8090:8090 and -e WEBUI_PORT=8090
This should alleviate the "white screen" issue.
If you have no webui , check the file /config/qBittorrent/qBittorrent.conf
edit or add the following lines
If you are running a very old (3.x) kernel you may run into this issue which can be worked around using this method
Usage¶
To help you get started creating a container from this image you can either use docker-compose or the docker cli.
docker-compose (recommended, click here for more info)¶
The ARM variants can be built on x86_64 hardware using multiarch/qemu-user-static
Once registered you can define the dockerfile to use with -f Dockerfile.aarch64.
Versions¶
- 07.10.23: - Install unrar from linuxserver repo.
- 10.08.23: - Bump unrar to 6.2.10.
- 17.06.23: - Deprecate armhf as per https://www.linuxserver.io/armhf.
- 10.06.23: - Bump unrar to 6.2.8.
- 23.02.23: - Add qt6-qtbase-sqlite to support SQLite database for resume files.
- 29.11.22: - Add openssl1.1-compat for qbittorrent-cli.
- 31.10.22: - Add libtorrentv1 branch.
- 31.08.22: - Rebase to Alpine Edge again to follow latest releases.
- 12.08.22: - Bump unrar to 6.1.7.
- 16.06.22: - Rebase to Alpine 3.16 from edge.
- 25.05.22: - Fetch qbitorrent-cli from upstream repo.
- 02.03.22: - Add unrar, 7zip, and qbitorrent-cli.
- 01.03.22: - Add python for search plugin support.
- 23.02.22: - Rebase to Alpine Edge, install from Alpine repos.
- 19.02.22: - Add jq to build-stage
- 07.01.22: - Rebase to Alpine, build from source.
- 06.01.22: - Deprecate unstable branch.
- 10.02.21: - Rebase to focal.
- 20.01.21: - Deprecate
UMASK_SET in favor of UMASK in baseimage, see above for more information. - 12.11.20: - Stop creating /config/data directory on startup
- 03.04.20: - Fix adding search engine plugin
- 02.08.19: - Add qbitorrent-cli for processing scripts.
- 23.03.19: - Switching to new Base images, shift to arm32v7 tag.
- 14.01.19: - Rebase to Ubuntu, add multi arch and pipeline logic.
- 25.09.18: - Use buildstage type build, bump qbitorrent to 4.1.3.
- 14.08.18: - Rebase to alpine 3.8, bump libtorrent to 1.1.9 and qbitorrent to 4.1.2.
- 08.06.18: - Bump qbitorrent to 4.1.1.
- 26.04.18: - Bump libtorrent to 1.1.7.
- 02.03.18: - Bump qbitorrent to 4.0.4 and libtorrent to 1.1.6.
- 02.01.18: - Deprecate cpu_core routine lack of scaling.
- 19.12.17: - Update to v4.0.3.
- 09.02.17: - Rebase to alpine 3.7
- 01.12.17: - Update to v4.0.2.
- 27.11.17: - Update to v4 and use cpu_core routine to speed up builds.
- 16.09.17: - Bump to 3.3.16, Add WEBUI_PORT variable and notes to README to allow changing port of webui.
- 01.08.17: - Initial Release.
- 12.02.18: - Initial Release.
Last update: October 8, 2023
Created: February 6, 2019
\ No newline at end of file
+Once registered you can define the dockerfile to use with -f Dockerfile.aarch64.
Versions¶
- 07.10.23: - Install unrar from linuxserver repo.
- 10.08.23: - Bump unrar to 6.2.10.
- 17.06.23: - Deprecate armhf as per https://www.linuxserver.io/armhf.
- 10.06.23: - Bump unrar to 6.2.8.
- 23.02.23: - Add qt6-qtbase-sqlite to support SQLite database for resume files.
- 29.11.22: - Add openssl1.1-compat for qbittorrent-cli.
- 31.10.22: - Add libtorrentv1 branch.
- 31.08.22: - Rebase to Alpine Edge again to follow latest releases.
- 12.08.22: - Bump unrar to 6.1.7.
- 16.06.22: - Rebase to Alpine 3.16 from edge.
- 25.05.22: - Fetch qbitorrent-cli from upstream repo.
- 02.03.22: - Add unrar, 7zip, and qbitorrent-cli.
- 01.03.22: - Add python for search plugin support.
- 23.02.22: - Rebase to Alpine Edge, install from Alpine repos.
- 19.02.22: - Add jq to build-stage
- 07.01.22: - Rebase to Alpine, build from source.
- 06.01.22: - Deprecate unstable branch.
- 10.02.21: - Rebase to focal.
- 20.01.21: - Deprecate
UMASK_SETin favor of UMASK in baseimage, see above for more information. - 12.11.20: - Stop creating /config/data directory on startup
- 03.04.20: - Fix adding search engine plugin
- 02.08.19: - Add qbitorrent-cli for processing scripts.
- 23.03.19: - Switching to new Base images, shift to arm32v7 tag.
- 14.01.19: - Rebase to Ubuntu, add multi arch and pipeline logic.
- 25.09.18: - Use buildstage type build, bump qbitorrent to 4.1.3.
- 14.08.18: - Rebase to alpine 3.8, bump libtorrent to 1.1.9 and qbitorrent to 4.1.2.
- 08.06.18: - Bump qbitorrent to 4.1.1.
- 26.04.18: - Bump libtorrent to 1.1.7.
- 02.03.18: - Bump qbitorrent to 4.0.4 and libtorrent to 1.1.6.
- 02.01.18: - Deprecate cpu_core routine lack of scaling.
- 19.12.17: - Update to v4.0.3.
- 09.02.17: - Rebase to alpine 3.7
- 01.12.17: - Update to v4.0.2.
- 27.11.17: - Update to v4 and use cpu_core routine to speed up builds.
- 16.09.17: - Bump to 3.3.16, Add WEBUI_PORT variable and notes to README to allow changing port of webui.
- 01.08.17: - Initial Release.
- 12.02.18: - Initial Release.
Created: February 6, 2019