TrueNAS Scale: Setting up qBitTorrent (including finding the login password)

Apps and Virtualization
1

This isn’t a step-by-step guide on how to configure qBitTorrent, but rather some things I came across when I was installing it on my own TrueNAS server to get it up and running. I’m no expert on this app, but I know just enough to get it up and running, so hopefully this helps someone to get this app up and running initially.

Initial App Configuration

Network Configuration

  • Since I need to set up port forwarding, I went to Network Configuration and enabled Host Network. This maps the jail to my local network.
  • Web Port - This is the port number that is used to access the qBitTorrent web interface.
  • BT Port - This is the port number that is actually used for Torrents. You may want to write this down in case it’s needed at your router.

Download Directory

qBitTorrent sends all of it’s downloads to the /downloads directory. We need to map this to an outside storage such as a downloads directory. To do so, first go to the Storage Configuration → qBittorrent Downloads Storage and set the following:

  • Type: Host Path (Path already exists on the system)
  • Host Path Configuration - Leave Enable ACL unchecked
  • Host Path - This is the actual directory in your pool, thus you want to set it to something like /mnt/pool/downloads directory.

Then create your app.

Finding That Initial Password

In the past, the initial username was admin while the password was adminadmin. While the initial username remains the same, the password is now randomly generated. Immediately after creating the jail, you want to access the logs as follows:

  1. Go to the qBitTorrent app.
  2. In the Workloads section, click on View Logs icon in the lower-right of that section.
  3. In the Choose Pod section, accept the defaults and click on Choose.
  4. Scan the logs for the line containing the word password and copy that password.
  5. Go back to the App screen, then go to the section Application Info, then click on the Web Portal icon.
  6. Log into with the username of admin and the password from step 4.

To change the password in qBitTorrent:

  1. Log into the qBitTorrent app.
  2. go to Tools → Options .
  3. Click on the Web UI tab.
  4. In the Authentication section, set a new username and password and write them down.
  5. Scroll down and click on Save.

To turn off authentication on your own network, you will need to know your IP address and subnet mask. All of my systems are on the 192.168.1.XXX network with a subnet mask of 255.255.255.0, thus the actual IP address I will be entering in is 192.168.1.0/24. Your own network configuration may vary. To set this bypass:

  1. Log into the qBitTorrent app.
  2. Go to Tools → Options .
  3. Click on the Web UI tab.
  4. Go to the Authentication section.
  5. Check off Bypass authentication for clients in whitelisted IP subnets
  6. In the box immediately below, put in your network address. (e.g. 192.168.1.0/24)
  7. Scroll down and click on Save.

Setting up a monitored folder

One nice feature of several Torrent clients is the ability to set up a monitor folder so that you can drop in the torrent files and have qBitTorrent automatically begin the download. I have a separate directory to go this automatically (e.g. is /mnt/pool/watch) which is mapped to the app internal directory (e.g. is /watch). To accomplish this:

  1. Go to the qBitTorrent App on TrueNAS SCALE.
  2. In the Application Info section, click on Edit.
  3. Go to Storage Configuration → Additional Storage
  4. For Type, select Host Path (path that already exists on the system)
  5. Leave Read Only unchecked.
  6. For Mount Path, type in /watch. If you use a different name, note it down.
  7. For Host Path Configuration, leave Enable ACL unchecked.
  8. For Host Path, this is where you want to configure the directory in your pool to be watched. This directory should already be created, so just select it. (e.g. /mnt/pool/watch).
  9. Scroll down to the bottom and click on Update.
  10. Wait one minute for the App to restart.
  11. Log into the qBitTorrent web interface.
  12. Go to Tools → Options.
  13. Go to the Downloads tab.
  14. Go to the Automatically add torrents from section.
  15. In the Monitored Folder section, add the internal directory you added from step 6 (e.g. /watch).
  16. In the Override Save Location section, leave it at Default save location.
  17. Scroll down to the bottom and click Save.

What will happen at this point is any torrent file you put into the watch directory (e.g. /mnt/pool/watch) will then be scanned by qBitTorrent, the download starts, and the torrent file will be deleted automatically.