docs-public/projects/qbittorent/index.md

title, description, date, lastmod, author, showHero

title	description	date	lastmod	author	showHero
qBittorrent	Quick overview of qBittorrent and setup	2025-02-04	2025-02-04	wompmacho	false

What is qBittorrent?

qBittorrent is a awesome, simple app that allows you to use classic QBittorrent in a docker container. I use QBittorrent because I can set it up with a VPN that only connects via the container directly. Effectively separating it from the rest of my network and allowing me to continue as normal while it is downloading. It will automatically stop the network if the VPN is not functioning correctly.

Docker Compose Example

# qbittorrentvpn - docker compose
## https://hub.docker.com/r/dyonr/qbittorrentvpn
---
version: "2"
services :
  qbittorrentvpn:
    container_name: qbittorrentvpn
    privileged: true
    image: dyonr/qbittorrentvpn
    environment :
      - VPN_ENABLED=true
      - VPN_USERNAME=VPN_USERNAME
      - VPN_PASSWORD=VPN_PASSWORD
      - LAN_NETWORK=10.0.0.0/24
      - WEBUI_PORT_ENV=8080
      - INCOMING_PORT_ENV=8999
    ports :
      - 8080:8080
      - 8999:8999
      - 8999:8999/udp
    volumes :
      - /app/QBittorrent/config:/config
      - /mnt/store/MediaServer/torrent:/downloads
    restart: unless-stopped

To set up the VPN you will need to have an existing account with a VPN service. Username & Password for the vpn will be provided as a key by your vpn service. In my case I use Surfshark and have to go log into my account, navigate to the linux setup page and grab my generated Username key and Password key there.

A credentials file on my docker host was generated by QBittorrent when running the first time.

## download all availble server conf
sudo wget https://my.surfshark.com/vpn/api/v1/server/configurations

## cp the server you want to use into config folder
/app/QBittorrent/config/openvpn

Once you restart your qbittorrentvpn docker container you can test your vpn service with a torrent leak test. Use the + add torrent link button to Download the torrent and test that your VPN service is connected and working.

• torrent-leak-test

Magnet links

Use magnet link and item hash to avoid logins

magnet:?xt=urn:btih:${HASH}