The LinuxServer.io team brings you another container release featuring easy user mapping and community support. Find us for support at:
- forum.linuxserver.io
- IRC on freenode at
#linuxserver.io
- Podcast covers everything to do with getting the most from your Linux Server plus a focus on all things Docker and containerisation!
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.
Usage
docker create \
--name=qbittorrent \
-v <path to config>:/config \
-v <path to downloads>:/downloads \
-e PGID=<gid> -e PUID=<uid> \
-e UMASK_SET=<022> \
-e WEBUI_PORT=<8080> \
-e TZ=<timezone> \
-p 6881:6881 \
-p 6881:6881/udp \
-p 8080:8080 \
linuxserver/qbittorrent
Parameters
The parameters are split into two halves, separated by a colon, the left hand side representing the host and the right the container side. For example with a port -p external:internal - what this shows is the port mapping from internal to external of the container. So -p 8080:80 would expose port 80 from inside the container to be accessible from the host's IP on port 8080 http://192.168.x.x:8080 would show you what's running INSIDE the container on port 80.
-p 6881
- the port(s)-p 6881/udp
- the port(s)-p 8080
- webui port-v /config
- where qbittorrent should store its config files-v /downloads
- path to downloads-e PGID
for GroupID - see below for explanation-e PUID
for UserID - see below for explanation-e UMASK_SET
for umask setting of qbittorrent, optional , default if left unset is 022.-e WEBUI_PORT
for changing the port of the webui, see below for explanation-e TZ
for timezone information, eg Europe/London
It is based on alpine linux with s6 overlay, for shell access whilst the container is running do docker exec -it qbittorrent /bin/bash
.
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=*
WebUI\ServerDomains=*
User / Group Identifiers
Sometimes when using data volumes (-v
flags) permissions issues can arise between the host OS and the container. We avoid this issue by allowing you to specify the user PUID
and group PGID
. Ensure the data volume directory on the host is owned by the same user you specify and it will "just work" ™.
In this instance PUID=1001
and PGID=1001
. To find yours use id user
as below:
$ id <dockeruser>
uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)
Setting up the application
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.
Info
Shell access whilst the container is running: docker exec -it qbittorrent /bin/bash
To monitor the logs of the container in realtime: docker logs -f qbittorrent
- container version number
docker inspect -f '{{ index .Config.Labels "build_version" }}' qbittorrent
- image version number
docker inspect -f '{{ index .Config.Labels "build_version" }}' linuxserver/qbittorrent
Versions
- 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.12.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.