binhex/arch-qbittorrent repository overview

⁠Application

qBittorrent⁠

⁠Description

qBittorrent is a bittorrent client programmed in C++ / Qt that uses libtorrent (sometimes called libtorrent-rasterbar) by Arvid Norberg. It aims to be a good alternative to all other bittorrent clients out there. qBittorrent is fast, stable and provides unicode support as well as many features.

⁠Build notes

Latest stable qBittorrent release from Arch Linux repo.

⁠Usage

docker run -d \
    -p 8080:8080 \
    -p 58946:58946 \
    -p 58946:58946/udp \
    --name=<container name> \
    -v <path for data files>:/data \
    -v <path for config files>:/config \
    -v /etc/localtime:/etc/localtime:ro \
    -e GLUETUN_INCOMING_PORT=<yes|no> \
    -e ENABLE_STARTUP_SCRIPTS=<yes|no> \
    -e DEBUG=<true|false> \
    -e HEALTHCHECK_COMMAND=<command> \
    -e HEALTHCHECK_ACTION=<action> \
    -e HEALTHCHECK_HOSTNAME=<hostname> \
    -e UMASK=<umask for created files> \
    -e WEBUI_PORT=<port> \
    -e QBITTORRENT_WEBUI_USER=<username> \
    -e QBITTORRENT_WEBUI_PASSWORD=<password> \
    -e PUID=<uid for user> \
    -e PGID=<gid for user> \
    binhex/arch-qbittorrent

Please replace all user variables in the above command defined by <> with the correct values.

⁠Access qBittorrent (web ui)

http://<host ip>:8080/

⁠Credentials

Username:- admin (or the value of QBITTORRENT_WEBUI_USER)

Password (if QBITTORRENT_WEBUI_PASSWORD not set):-

On first run a random password is auto-generated and shown in /config/supervisord.log. Look for a line like:

[info] QBITTORRENT_WEBUI_PASSWORD not set, auto-generated password: AbCdEfGh1

On first run (no config yet), set -e QBITTORRENT_WEBUI_PASSWORD=<your password> to use your own password instead of an auto-generated one.

On subsequent runs the env var is only used for API authentication (required when GLUETUN_INCOMING_PORT=yes). It will NOT overwrite whatever password is already stored in the config — that can only be changed from inside the WebUI under Options → Web UI → Authentication.

⁠PIA example

docker run -d \
    -p 8080:8080 \
    -p 58946:58946 \
    -p 58946:58946/udp \
    --name=qbittorrent \
    -v /root/docker/data:/data \
    -v /root/docker/config:/config \
    -v /etc/localtime:/etc/localtime:ro \
    -e GLUETUN_INCOMING_PORT=no \
    -e ENABLE_STARTUP_SCRIPTS=no \
    -e DEBUG=false \
    -e UMASK=000 \
    -e WEBUI_PORT=8080 \
    -e PUID=0 \
    -e PGID=0 \
    binhex/arch-qbittorrent

⁠WebUI notes

⁠Port

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.

⁠Password

The env var QBITTORRENT_WEBUI_PASSWORD is used for two things:

1. First run — hashed and written to the config as the initial password
2. All runs — used for API authentication (when GLUETUN_INCOMING_PORT=yes)

Once a password hash exists in the config (whether auto-generated or user-set), it is never overwritten by the env var. To change your password, use the WebUI under Options → Web UI → Authentication.

For example, to set the port to 8090 you need to set:-

    -p 8090:8090 \

and

    -e WEBUI_PORT=8090 \

If you appreciate my work, then please consider buying me a beer :D

Documentation⁠ | Support forum⁠