Skip to content
View in the app

A better way to browse. Learn more.

Unraid

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

[Support] binhex - qBittorrent

Featured Replies

1 minute ago, DoboY said:

Quick question, can I map another path for a separate folder?

I’ve never tested this but can’t see any problems. Easily reverted if there is some unexpected issue.

  • 3 weeks later...
  • Replies 68
  • Views 18.7k
  • Created
  • Last Reply

Top Posters In This Topic

Most Popular Posts

  • I have created a gluetun template as the existing one was out of date (missing env vars) and if im moving forward with gluetun support then i wanted full control, if you wish to give it a whirl then l

  • My bad. I need to stop trusting my memory.😁 I had it in my head that the qbit container was using the Privoxyvpn shared network. It’s not though. Just all the non-vpn arr containers. So not an issue h

  • For now the other VPN related images are maintained, i shall give the community plenty of notice IF (and it is a big if) i decide to deprecate the VPN images.

Posted Images

I just download and tried to setup this container, but it doesn't seem to include any VPN functionality by itself, as was in the description: "This Docker includes OpenVPN and WireGuard to ensure a secure and private connection to the Internet". Have I just missed something obvious, or do you really need another docker to make this work with a VPN?

8 minutes ago, xxzp3 said:

I just download and tried to setup this container, but it doesn't seem to include any VPN functionality by itself, as was in the description: "This Docker includes OpenVPN and WireGuard to ensure a secure and private connection to the Internet". Have I just missed something obvious, or do you really need another docker to make this work with a VPN?

You don’t need anything but an account with a VPN provider. I use PIA.

9 minutes ago, wgstarks said:

You don’t need anything but an account with a VPN provider. I use PIA.

Thanks for your reply. It looks like I might need to add some variables, but I can't find any guide/documentation on it. I've tried to set it up with ProtonVPN, but I can't figure out how to get it working. Is there any documentation on it that I have somehow missed? I feel like I'm missing something obvious.

56 minutes ago, xxzp3 said:

Thanks for your reply. It looks like I might need to add some variables, but I can't find any guide/documentation on it. I've tried to set it up with ProtonVPN, but I can't figure out how to get it working. Is there any documentation on it that I have somehow missed? I feel like I'm missing something obvious.

Checkout the first post in this thread.

  • Author
5 hours ago, xxzp3 said:

I just download and tried to setup this container, but it doesn't seem to include any VPN functionality by itself, as was in the description: "This Docker includes OpenVPN and WireGuard to ensure a secure and private connection to the Internet". Have I just missed something obvious, or do you really need another docker to make this work with a VPN?

This is correct, this image does not include a VPN, I've spotted where you are seeing this and it's a copy/paste mistake by me from an image that DOES include VPN connectivity (qbittorrentvpn for example).

Having said the above i am using this image myself with the gluetun functionality which gives you VPN protection including port forwarding (if your provider supports it), this does require you setting up gluetun seperately and then setting this container to use the gluetun containers network, once you got this going it does become a very flexible solution, alternatively take a look at the qbittorrentvpn image.

Edit - Fixed the copy/paste issue in the template.

7 hours ago, xxzp3 said:

I just download and tried to setup this container, but it doesn't seem to include any VPN functionality by itself, as was in the description: "This Docker includes OpenVPN and WireGuard to ensure a secure and private connection to the Internet". Have I just missed something obvious, or do you really need another docker to make this work with a VPN?

7 hours ago, wgstarks said:

You don’t need anything but an account with a VPN provider. I use PIA.

Sorry for my misguided post. Thought I was posting in the qbittorrentvpn thread. I really should pay more attention. 😳

On 11/11/2025 at 11:12 PM, binhex said:

This is correct, this image does not include a VPN, I've spotted where you are seeing this and it's a copy/paste mistake by me from an image that DOES include VPN connectivity (qbittorrentvpn for example).

Having said the above i am using this image myself with the gluetun functionality which gives you VPN protection including port forwarding (if your provider supports it), this does require you setting up gluetun seperately and then setting this container to use the gluetun containers network, once you got this going it does become a very flexible solution, alternatively take a look at the qbittorrentvpn image.

Edit - Fixed the copy/paste issue in the template.

Thank you! I was kinda questioning my sanity, not being able to figure it out. I'll try another solution.

I apologize if there already was a thread, or post about it, but I'd like to ask if there is any possibility to downgrade libtorrent version?

  • Author
19 hours ago, rogales said:

I apologize if there already was a thread, or post about it, but I'd like to ask if there is any possibility to downgrade libtorrent version?

i produce libtorrent v1 and v2 images, if you want to use libtorrent v1 then add :latest-libtorrentv1 to the repositoy name and apply, libtorrentv2 is simply tag name :latest

So I'm running into a strange issue not sure where the issue is:


when i updated my gluetun container to :latest it no longer forwards the port to this container, i see the port forward working in gluetun

2025-11-22T11:21:35-06:00 INFO [http server] 301 GET /v1/openvpn/portforwarded wrote 50B to 127.0.0.1:58166 in 19.464µs

2025-11-22T11:21:35-06:00 INFO [http server] 401 GET /v1/publicip/ip wrote 13B to 127.0.0.1:58168 in 4.5µs

but in the qbittorrent logs:
[WARN] Incoming port is not set, cannot verify application incoming port matches VPN port

[WARN] Incoming port is not set, this may be due to the VPN not being connected or the gluetun Control Server not being available, checking again in 60 seconds...


when i roll my gluetun container back to qmcgaw/gluetun:pr-2586 it starts working again

[INFO] External verification: Incoming port '47561' is reachable.

[INFO] Previous VPN port forward '47561' and current VPN port forward '47561' are the same, checking again in 60 seconds...

[INFO] Sleeping for 60 seconds before re-checking port assignment...

Im not sure if this issue is on gluetun's side or if something else is going on.

  • Author
3 hours ago, DeadChimi said:

So I'm running into a strange issue not sure where the issue is:


when i updated my gluetun container to :latest it no longer forwards the port to this container, i see the port forward working in gluetun

2025-11-22T11:21:35-06:00 INFO [http server] 301 GET /v1/openvpn/portforwarded wrote 50B to 127.0.0.1:58166 in 19.464µs

2025-11-22T11:21:35-06:00 INFO [http server] 401 GET /v1/publicip/ip wrote 13B to 127.0.0.1:58168 in 4.5µs

but in the qbittorrent logs:
[WARN] Incoming port is not set, cannot verify application incoming port matches VPN port

[WARN] Incoming port is not set, this may be due to the VPN not being connected or the gluetun Control Server not being available, checking again in 60 seconds...


when i roll my gluetun container back to qmcgaw/gluetun:pr-2586 it starts working again

[INFO] External verification: Incoming port '47561' is reachable.

[INFO] Previous VPN port forward '47561' and current VPN port forward '47561' are the same, checking again in 60 seconds...

[INFO] Sleeping for 60 seconds before re-checking port assignment...

Im not sure if this issue is on gluetun's side or if something else is going on.

Please can you paste the entire /config/supervisord.log file, ensure you redact any sensitive info.

Edit - Please ensure you have the latest abittorrent image, so do a 'check for updates' and apply, this should then support either version of gluetun (gluetun api change in latest).

DISREGARD, They changed a few paths for the config.toml file, and I didnt realize it was a super recent (4 day old) change. Updated the path in the config.toml for portforward and it works.

If anyone is coming here with issues for this my old config.toml file on the Gluetun container, contained routes = [GET /v1/openvpn/portforwarded] it needed to be changed to ["GET /v1/portforward"] so my config.toml file for this to work looks as follows:

[[roles]]

name = "binhex-qbittorrent"

# Define a list of routes with the syntax "Http-Method /path"

routes = ["GET /v1/portforward"]

# Define an authentication method with its parameters

auth = "yourpreferredauthmethodhere"

sorry if this caused you any extra work.

Edited by DeadChimi

  • 2 weeks later...

I was wondering how normal is it that I'm only getting about 50-70MiB/s on unraid with qbittorrent. I'm used to getting quite higher speeds and more stable. Previously using deluge and windows though. Have tried deluge here too, but that was even worse when it came to speed.

I would like to ask what's the easiest, and best way to install qbitorrent-api (it's necessary for a script I use every time when new torrent is added).
Thanks

Edited by rogales

  • Author
3 hours ago, rogales said:

I would like to ask what's the easiest, and best way to install qbitorrent-api (it's necessary for a script I use every time when new torrent is added).
Thanks

You don't install an API it is either present or not depending on the application, for qbittorrent-nox it is present, so you can use it right now nothing needs to be done.

I need the Python library qbittorrent-api (PyPI package), not the built-in Web API. My Python script uses import qbittorrentapi which isn't available in the container by default. Should I install it via pip or rewrite my script to use requests + Web API directly?

Edited by rogales

  • Author
On 12/5/2025 at 8:52 PM, rogales said:

I need the Python library qbittorrent-api (PyPI package), not the built-in Web API. My Python script uses import qbittorrentapi which isn't available in the container by default. Should I install it via pip or rewrite my script to use requests + Web API directly?

my advice would be to keep your python script out of the container (run on unraid or another container more suited like python).

  • 1 month later...

I have the container installed and it's working fine except for one issue: it is not set to autostart, but somehow it starts when the array restarts. No user scripts doing this either. Any ideas what might be causing this? I also noticed the same thing happening with the Krusader container, but I switched to the ich777 version because of other issues, and it doesn't happen with that version.

Edited by bar_foo

For some reason I keep getting this error trying to set up AirVPN with wireguard. There is no place to put the preshared key though, not in advanced settings or anything. making a custom variable with 'WIREGUARD_PRESHARED_KEY" doesn't work either. Any thoughts?

2026-01-29T18:24:15Z ERROR VPN settings: Wireguard settings: pre-shared key is not set

3 hours ago, kkowalski said:

For some reason I keep getting this error trying to set up AirVPN with wireguard. There is no place to put the preshared key though, not in advanced settings or anything. making a custom variable with 'WIREGUARD_PRESHARED_KEY" doesn't work either. Any thoughts?

2026-01-29T18:24:15Z ERROR VPN settings: Wireguard settings: pre-shared key is not set

You’ll need to use a configuration file. See the documentation- https://github.com/binhex/documentation/blob/master/docker/faq/vpn.md

Scroll down to Q28.

  • Author
16 hours ago, kkowalski said:

For some reason I keep getting this error trying to set up AirVPN with wireguard. There is no place to put the preshared key though, not in advanced settings or anything. making a custom variable with 'WIREGUARD_PRESHARED_KEY" doesn't work either. Any thoughts?

WIREGUARD_PRESHARED_KEY is used in the gluetun container and is available (binhex-official-gluetun) as a env var:

{C01F66EA-B3BE-4E8E-84CE-481282D588D9}.png

  • 3 weeks later...

New to Unraid and Dockers. I was manually duplicating setting from my existing Windows install to this app. After clicking save, I got a white screen with the menu links appearing on the left side...clearly a broken display. When I closed the app and reopened I got a login screen but everything was left aligned rather then the standard centered. I also could no longer login. I replaced the config file with the original contents to get back in. As you'll see in the log file, the password was still the default. I replaced the email, username, and passwords in the log file with generic ones. Hoping someone can figure out what setting in this log caused this, so I can avoid it when I attempt to enter the settings again. Thank you in advance for your consideration.

qBittorrent problem.txt

So, I am running into issues running multiple QBIT containers, I made sure to update the app directory to a new entry and changed all the ports to a new one for each instance and it will turn on run but im unable to access the webUI at all, I think it has something to do with the docker container ports not updating with the LAN ports that you can change in the setup process.
Docker ports: LAN ports:


Okay so I fixed it, I had to remove the Host Port 3 mapping and readd it using the new port needed for the web UI

image.png

Edited by Kognac

  • 2 months later...

Yesterday QB randomly stopped displaying the Torrent Options Dialog or is it called Add Torrent dialog (allows you to rename the torrent, select the category, etc) when manually adding a torrent from the Search window. I have added dozens of torrents in the last week, and before yesterday this windows always appeared without fail. I'm the only person with access, and I have not touched any settings in at least a week. In the Windows version, there's a setting in Downloads called "Display torrent content and some options". I presume that's the setting I need, but that is not in the binhex version. That being said, how do I get that window to appear again.

Edited by CaptainKen

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

Account

Navigation

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.