royborgen/qbt-port-update repository overview

⁠qBittorrent Port Update

This repository contains a Python script that fetches the forwarded port from Gluetun and checks if it matches the listening port listed in qBittorrent.conf. If there is a discrepancy, the script will stop the qBittorrent container, update the qBittorrent.conf file with the new port, and restart qBittorrent.

The script can be configured to read Gluetun's forwarded_port or fetch it from the Gluetun Control Server.

This container ensures that the qBittorrent's listening port is always updated after any Watchtower-initiated container updates, restarts, or server reboots.

⁠Background

Most VPN providers do not allow setting a static forwarded port, causing the forwarded port to change each time Gluetun restarts. This script helps keep qBittorrent updated with the latest port, ensuring it remains connectable.

⁠Run in Docker container

docker run -d \
  --name qbt-port-update \
  -v /srv/qbt-port-update:/config \
  -v /srv/gluetun/forwarded_port:/config/gluetun/forwarded_port \
  -v /srv/qBittorrent:/config/qBittorrent \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e TZ=Europe/Oslo \
  -e QBT_CONTAINER_ID=qbittorrent \
  -e CREATE_LOG_FILE=yes \
  -e LOGTIMEFORMAT=%d-%m-%Y\ %H:%M:%S \
  -e CRON_SCHEDULE=*/15\ *\ *\ *\ * \
  --restart unless-stopped \
  royborgen/qbt-port-update:latest

Se docker-compose.yaml⁠ if you wish to use docker compose to start the container

⁠Supported enviroment variables

CREATE_LOG_FILE=yes/no
CRON_SCHEDULE=*/15 * * * *  
GLUETUN_IP=127.0.0.1
GLUETUN_PORT=8000
GLUETUN_USER=username
GLUETUN_PASS=password
LOGFILE=/config/qbt_port_update.log
LOGTIMEFORMAT=%d-%m-%Y %H:%M:%S 
PATH_GLUETUN=/config/gluetun/forwarded_port
PATH_QBITTORRENT=/config/qBittorrent/qBittorrent.conf
PUID=1000
PGID=1000
TZ=Europe/Oslo
QBT_CONTAINER_ID=qbittorrent

• CREATE_LOG_FILE should only container yes or no
• CRON_SCHEDULE require the use of correctly formated cron job. If not set the script will execute by default every 15th minute.
• GLUETUN_IP Required from Gluetun 4.0.0. Needs to contain Gluetun server IP.
• GLUETUN_PORT is requered from Gluetun v.4.0.0. Need to contain the Gluetun Control Server listening port. Default port is 8000.
• GLUETUN_USER Username for the Gluetun Control Server API. Required from Gluetun 3.40.0.
• GLUETUN_PASS Password for the Gluetun Control Server API. Required from Gluetun 3.40.0.
• LOGTIMEFORMAT controls the time format of the logfile. This can be adjusted to your liking.
• CONTAINER_ID must container name or ID of the qBittorrent container you are running. This is needed so that we can restart the container.
• TZ allows you to set the time zone displayed in the log. For a complete overview of timezones, see the section TZ identifiers on list of tz database time zones⁠ available on Wikipedia.
• PUID and PGID allow you to control which user and group that owns the config folder and the qbt_port_update.log file. If not provided, the id of the user running the container is used. Changing this is useful when running containers with different users on the system to avoid conflicting ownership. If you want to assign ownership to a specific non-root user (e.g., 1000), you can provide the respective PUID and PGID values.

⁠Logging

The creates by default i logfile updates.log in the scripts directory. You can modify the path in the config file.

Log sample:

23-11-2024 02:02:18 - INFO - qBittorrent Port Update started...
23-11-2024 02:02:18 - INFO - Fetching forwarded port from Gluetun Control Server on IP: 127.0.0.1:8000
23-11-2024 02:02:18 - INFO - Forwarded port is 43253
23-11-2024 02:02:18 - INFO - Reading qBittorrent config file: /config/qBittorrent/qBittorrent.conf
23-11-2024 02:02:18 - INFO - Session\Port=62080
23-11-2024 02:02:18 - INFO - Forwarded port has changed! Updating qBittorrent.conf
23-11-2024 02:02:18 - INFO - Stopping container qbittorrent
23-11-2024 02:02:28 - INFO - Container successfully stopped!
23-11-2024 02:02:28 - INFO - Session\Port updated with value 43253
23-11-2024 02:02:28 - INFO - Starting container qbittorrent
23-11-2024 02:02:29 - INFO - Container successfully started!
23-11-2024 02:02:29 - INFO - qBittorrent Port Update completed
23-11-2024 02:15:02 - INFO - qBittorrent Port Update started...
23-11-2024 02:15:02 - INFO - Fetching forwarded port from Gluetun Control Server on IP: 127.0.0.1:8000
23-11-2024 02:15:02 - INFO - Forwarded port is 43253
23-11-2024 02:15:02 - INFO - Reading qBittorrent config file: /config/qBittorrent/qBittorrent.conf
23-11-2024 02:15:02 - INFO - Session\Port=43253
23-11-2024 02:15:02 - INFO - Forwarded port is unchanged! No changes made to qBittorrent.conf
23-11-2024 02:15:02 - INFO - qBittorrent Port Update completed

⁠Source Code

This project is open source under the GPL-2.0 license. View the source code and license on GitHub⁠