Skip to content

qBittorrent vpn

Cody edited this page Jun 16, 2019 · 9 revisions
WANT TO HELP? CLICK THE ★ (STAR LOGO) in the Upper-Right!

  • 📂 [Click Here] - Google G-Suite (Unlimited Hard Drive Space & Storage)
  • 📂 [Click Here] - Top Performance NewsHost! - Blitz Members Receive a 58% Discount

Table of Contents

  1. Intro
  2. Summary
  3. Access Information
  4. Configuration

1. Intro

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. This Docker image is using the headless configuration with the web frontend enabled, as well as OpenVPN to ensure a secure and private connection to the Internet, including use of iptables to prevent IP leakage when the tunnel is down. Privoxy is also included to allow unfiltered access to index sites, to use Privoxy please point your application at qbittorrent:8118. (credit: binhex)

For the non-vpn version of this app, see qBittorrent.

2. Summary

qBittorrent will run in a default configuration with OpenVPN and Privoxy disabled. Some settings are already configured for you, plus a P2P Blocklist (credit: John Tyree).

See section 4 for more advanced configurations including how to configure your VPN.

3. Access Information

Protocol Address Notes
traefik** qbittorrent:8998 Only for Internal App-to-App Communication
https Traefik must be Deployed; Remote Servers
http Poor Security Practice - Stop with PG Port Guard
http ipv4:8998 Ideal Only for Local Servers
privoxy† qbittorrent:8118 Only for Internal App-to-App Communication

** Ideal for Apps to communicate between with one another. Click Here for more info!

† Privoxy allows your other Apps to use the qBittorrent's internet connection including its VPN configuration.

4. Configuration

Some essential settings are auto-configured by default when the app is deployed.


The Default login is configured as follows:

Username Password
admin pgblitz

OpenVPN Configuration

The VPN is not enabled by default. To use it, the following must be performed:

  1. Place your .ovpn file in /opt/appdata/qbittorrent/openvpn
  2. Populate the VPN_USER variable with your VPN username.
  3. Populate the VPN_PASS variable with your VPN password.
  4. Set VPN_ENABLED to yes
  5. (Optional) Configure additional OpenVPN settings with VPN_OPTIONS

If you cannot connect to your container after enabling VPN, check your logs. If you do not see [info] qBittorrent process listening on port 8998 then there may be a problem with your VPN configuration.

Jackett Plugin

qBittorrent can use Jackett as a search provider. See the instructions and download the search provider.


qBittorrent uses a feeds.json file located under opt/appdata/qbittorrent/qBittorrent/config/rss

The contents should be similar to the following example:

  "feeds": [
      "name": "The New Books",
      "url": "http://rss.domain.example/author/some-guy.rss",
      "savepath": "/mnt/hd/books/Some Guy",
      "category": "Books",
      "filters": [
          "field": "title",
          "regex": ".*epub.*"
    { ... }

Environmental Variables

Variable Value Notes
PUID 1000
PGID 1000
VPN_ENABLED no yes/no
VPN_USER username VPN username
VPN_PASS password VPN password
VPN_PROV custom custom, pia or airvpn
VPN_OPTIONS Additional OpenVPN configuration
NAME_SERVERS,,, Cloudflare, DNS.Watch, OpenDNS, OpenNIC
DEBUG false true/false
WEBUI_PORT 8998 Must match Internal port

Default Paths (configured automatically)

In case you are upgrading or change the paths and it's causing problems, here are the default paths to assist you! Categories do not need to specify a path, by default it uses downloadPath/categoryName when not set!

Path Info
Temporary Download Folder /mnt/incomplete/qbittorrent
Completed Download Folder /mnt/downloads/qbittorrent
Saved Torrents Folder /mnt/torrent
Torrent Watch Folder /mnt/torrent/watch

Useful Starter Links

  1. Introduction
  2. Blitz YouTube Channel
  3. G-Suite Signup
  4. Recommended NewsHosts

Prior Planning 101

  1. Recommended Pre-Reading
  2. Server - Storage Planning
  3. Usenet or BitTorrent
  4. PG Editions
  5. PG Folder Structure
  6. PGBlitz Repos
  7. Common Issues

Deploy & Config

  1. SSH Server Access
  2. Create a SUDO User
  3. Install PGBlitz
  4. WatchTower
  5. Remote Path Mappings

Data Transport
  1. PG Clone
    1. Google OAuth Keys
    2. PG Move
    3. PG Blitz
    4. 2nd HD Option

Key Components

  1. Traefik
  2. Port Guard
  3. PG Shield
  4. PG Press
  5. Google Cloud - GCE
    1. Automated setup
  6. Hetzner Cloud
  7. PG Fork
  8. Extra PG Commands

Blitz App Info

  1. Accessing PG Apps
  2. App Port Scheme
  3. Trigger Plex autoscan with Sonarr and Radarr

Tools & Services

Core Apps [Expand]
  1. Emby
  2. Jackett
  3. Jellyfin
  4. LazyLibrarian
  5. Lidarr
  6. Netdata
  7. NZBGet
  8. Ombi
  9. Plex
  10. Portainer
  11. qBittorrent
  12. Radarr
  13. RuTorrent
  15. Sonarr
  16. Tautulli
Community Apps [Expand]
  1. AirSonic
  2. AllTube
  3. Bazarr
  4. Beets
  5. Bitwarden
  6. BookSonic
  7. cAdvisor
  8. Cloud Commander
  9. DDClient
  10. Deezloaderremix
  11. Deluge
  12. DelugeVPN
  13. Dozzle
  14. Duplicati
  15. EmbyStats
  16. FlexGet
  17. Gazee
  18. Gitea
  19. Handbrake
  20. Headphones
  21. Heimdall
  22. HomeAssistant
  23. HTPCManager
  24. JDownloader2
  25. jd2-openvpn
  26. Kitana
  27. Logarr
  28. MakeMKV
  29. MariaDB
  30. McMyadmin
  31. MEDUSA
  32. Mellow
  33. Monitorr
  34. Muximux
  35. Mylar
  36. NextCloud
  37. NowShowing
  38. NZBHydra2
  39. NZBThrottle
  40. Organizr
  41. pyLoad
  42. qBittorrent
  43. qBittorrent-vpn
  44. Radarr4k
  45. Resilio
  46. rflood-openvpn
  47. rutorrent-openvpn
  48. ShareSite
  49. Shoko Anime Server
  50. SpeedTest
  51. SyncLounge
  52. Syncthing
  53. Teamspeak3
  54. The Lounge
  55. Transmission
  56. Trakt.or
  57. Ubooquity
  58. vnc-xfce
  59. xTeVe
  60. Zammad

Misc Info & Articles

  1. Change Server Time
  2. Fail2Ban
  3. Custom Containers
  1. Scripting Area
    1. Auto Upload for Sonarr and Lidarr
    2. Auto Delete Log
    3. Plex Plugin DB Backup
    4. Plex fast BACKUP
Clone this wiki locally
You can’t perform that action at this time.