Skip to content

qBittorrent

BitTorrent client

Ansible vault
# qbittorrent

hazzuk_media_qbittorrent_enabled: true

hazzuk_media_qbittorrent_stack:
  qbittorrent:
    domain: "qbittorrent.{{ karo_compose_root_domain }}"
    downloads_path: "" # e.g. /media/drive1/data/torrents
    webui_enabled: true
  qui:
    domain: "qui.{{ karo_compose_root_domain }}"
    log_level: info # trace, debug, info, warn, error
    session_secret: "" # `openssl rand -hex 16`
    oidc_client_id: ""
    oidc_client_secret: ""

See all defaults

qBittorrent - BitTorrent client
qBittorrent setup
  • Obtain the generated qBittorrent web UI login credentials

    # ssh dockeruser@homeserver.example.com
    docker logs qbittorrent
    
  • Go to 'Options' > 'Web UI'
  • Username: karo
  • ( Press 'Save')
  • Password: <new secure password> (e.g. openssl rand -hex 16)
  • ( Press 'Save')
  • Go to 'Options' > 'Downloads'
  • Default save path: /data/torrents
  • Go to 'Options' > 'Advanced'
  • IP address reported to trackers: <vpn's static ipv4 address> (optional)
  • Recreate the stack with webui_enabled: false
qui - Modern web interface for qBittorrent
qui setup
  • Go to 'Settings' > 'Instances'

  • Add qBittorrent instance

    • Instance Name: Homeserver
    • URL: http://localhost:9814
    • Username: karo
    • Password: <qbittorrent password>
  • Go to 'Instances' > 'Homeserver' > 'Categories'

  • Add Categories (e.g. iso, books, series, movies)

    The save path isn't required, as it'll be the same as the category name.

Test to ensure qBittorrent, qui and your VPN connection with Gluetun are all working correctly.