Repository files navigation

Docker container which runs the latest qBittorrent-nox client while connecting to WireGuard or OpenVPN with netfilter killswitch to prevent IP leakage when the tunnel goes down.

• Netfilterkillswitch to prevent IP leaking when VPN connection fails
• Selectively enable or disableWireGuard orOpenVPN support
• IPv6 support
• ConfigurableUID andGID for config files and /downloads for qBittorrent
• Build foramd64,arm64,armv8 andarmv7
• ...

• Modify one of theexample compose files to your needs.
• Create the necessary VPN config files.

Then start the container by running:

docker compose up -d

WARNING: Only with thelatest tag will you continuously receive updates.

If there are multiple config files present, one will be choosen randomly.

The container will fail to boot ifVPN_ENABLED is set and there is no validINTERFACE.conf file present in the/config/wireguard directory. Drop a.conf file from your VPN provider into/config/wireguard and start the container again.

Recommended INTERFACE names includewg0 orwgvpn0 or evenwgmgmtlan0. However, the number at the end is in fact optional, and really any free-form string[a-zA-Z0-9_=+.-]{1,15} will work. So even interface names corresponding to geographic locations would suffice, such ascincinnati,nyc, orparis, if that's somehow desirable.[source]

The container will fail to boot ifVPN_ENABLED is set and there is no validFILENAME.ovpn file present in the/config/openvpn directory. Drop a.ovpn file from your VPN provider into/config/openvpn (if necessary with additional files like certificates) and start the container.

You can either use the environment variablesVPN_USERNAME andVPN_PASSWORD or store your credentials inopenvpn/credentials.conf. Those credentials will be used to create credential files for all VPN configs initially.If you manually store your VPN credentials inopenvpn/FILENAME_credentials.conf, those will be used for the particular VPN config.

YOURUSERNAMEYOURPASSWORD

User ID (PUID) and Group ID (PGID) can be found by issuing the following command for the user you want to run the container as:

id<username>

Just mount your script to/custom-cont-init.d in the container. Those scripts are executed before any of the default init scripts.Seedocs/examples/scripts for examples.

You can use theDockerfile with all architectures and versions of qBT that are listedhere.

If you don't specify any tags, the latest release version will be used.

$ git clone https://github.com/Trigus42/alpine-qbittorrentvpn.git$cd alpine-qbittorrentvpn$ QBITTORRENT_TAG={TAG} docker build -f Dockerfile -t qbittorrentvpn.

Build for all supported architectures:

$ QBITTORRENT_TAG={TAG} docker buildx bake -f bake.yml

If you want to use this command to push the images to a registry (append--push to the above command), you have to modify theimage setting inbake.yml.

When encountering an issue, please first attempt to reproduce it using the most up-to-date stable versions of Docker, your operating system, kernel, and the container itself.

Before opening a new issue, please refer to previously reported issues as well as thecommon issues. Your issue might have already been addressed, or there may be ongoing discussions that you can join.

Upon opening an issue, kindly provide the following details:

• Full logs from container boot to exit, preferably with theDEBUG=yes environment variable set.
• Your Docker compose file or Docker run command.
• Depending on your situation, other relevant information such as:
  • The image where the issue first arose. Including tag information such as date and commit hash can be immensely useful, especially if you suspect that a recent change may have introduced the problem.
  • Your VPN config file, with any keys and other sensitive information removed.
  • Any additional details that may be relevant to your specific situation.

While logs should not display passwords and keys, it is highly recommended to review them for any sensitive information. Depending on your particular case, you might also want to redact IP addresses and domain names.

• alpine (base image)
• qBittorrent
• WireGuard /OpenVPN
• ...

This image was inspired by and is partially based onDyonR/docker-qbittorrentvpn,MarkusMcNugen/docker-qBittorrentvpn andbinhex/arch-qbittorrentvpn.