Torrents

The Torrents stack, comprising the torrents-qBittorrent and torrents-gluetun containers, facilitates downloads via the BitTorrent protocol over a VPN connection.

Service	URL	Purpose	Project
gluetun	/	VPN connection	qdm12/gluetun
qBittorrent	downloads.fjellhei.men	Download torrents	linuxserver/qbittorrent

"Gluetun is a lightweight and versatile VPN client that supports multiple providers, protocols, and features."

"qBittorrent is a cross-platform software that lets you download and share files via the BitTorrent protocol."

Networking

The gluetun container functions as a tunnel, directing all of qBittorrent's traffic through it by configuring network_mode: "service:gluetun" on qBittorrent. The gluetun container itself routes traffic through an OpenVPN connection. Setting depends_on: gluetun on qBittorrent ensures the container starts and operates only when the gluetun container is running properly.

Access WEBUI

We can set port 9090 on qbittorrent for WEBUI access. However, since qbittorrent utilizes gluetun for its network, to access that port, we need to expose it on the gluetun container and then access the WEBUI from the gluetun container.

ENV

qBittorrent

Variable	Value	Note
WEBUI_PORT	9090	Access qBittorrent from browser

gluetun

To select/configure the VPN provider and necessary environment variables, please refer to the documentation.

Variable	Value	Note
VPN_TYPE	openvpn	Set VPN type to OpenVPN
VPN_SERVICE_PROVIDER	<provider>	The VPN provider
OPENVPN_USER	<username>	VPN username
OWNED_ONLY	yes	Use only servers owned by provider

docker-compose.yaml

---
name: torrents

services:

  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    container_name: torrents-qbittorrent
    volumes:
      - /homeserver/torrents/data//qbittorrent/config:/config
      - /xdrive/Media/Downloads:/downloads
    network_mode: "service:gluetun"
    env_file:
      - /homeserver/.env
    environment:
      - WEBUI_PORT=9090
    healthcheck:
      test: curl --fail http://localhost:9090 || exit 1
      interval: 1m
      start_period: 20s
      timeout: 10s
      retries: 3
    restart: unless-stopped

  gluetun:
    image: qmcgaw/gluetun:latest
    container_name: torrents-gluetun
    cap_add:
      - NET_ADMIN
    expose:
      - '9090'
    networks:
      - proxy-network
    env_file:
      - /homeserver/.env
      - /homeserver/torrents/gluetun.env
    environment:
      - VPN_TYPE=openvpn
    restart: unless-stopped

networks:
  proxy-network:
    external: true