Skip to content
qbittorrent-nox-static

Installing nox

Once the script has successfully built qbittorrent-nox you can install the binary using this command:

bash ~/qbittorrent-nox-static.sh install
bash ~/qbittorrent-nox-static.sh -b "/path/to/built/binary" install

The default installation path is determined by type of user executing the script.

Built to - qbt-build

Optionally installed to /usr/local/bin/qbittorrent-nox

GitHub Releases

Optionally you can just download the existing prebuilt binaries released using GitHub Actions.

Without ICU

mkdir -p ~/bin && source ~/.profile
wget -qO ~/bin/qbittorrent-nox https://github.com/userdocs/qbittorrent-nox-static/releases/latest/download/x86_64-qbittorrent-nox
chmod 700 ~/bin/qbittorrent-nox

With ICU

mkdir -p ~/bin && source ~/.profile
wget -qO ~/bin/qbittorrent-nox https://github.com/userdocs/qbittorrent-nox-static/releases/latest/download/x86_64-icu-qbittorrent-nox
chmod 700 ~/bin/qbittorrent-nox

Configuring qbittorrent

If you want to configure qBittorrent before you start it use this method:

Create the default configuration directory.

mkdir -p ~/.config/qBittorrent

Create the configuration file.

touch ~/.config/qBittorrent/qBittorrent.conf

Edit the file

nano ~/.config/qBittorrent/qBittorrent.conf

Add this. Make sure to change your web ui port.

[LegalNotice]
Accepted=true


[Preferences]
WebUI\Port=PORT

Default login:

username: admin
password: adminadmin

Some key start-up arguments to help you along. Using the command above with no arguments will loads the defaults or the settings defined in the ~/.config/qBittorrent/qBittorrent.conf

Usage:
    ./qbittorrent-nox [options] [(<filename> | <url>)...]
Options:
    -v | --version             Display program version and exit
    -h | --help                Display this help message and exit
    --webui-port=<port>        Change the Web UI port
    -d | --daemon              Run in daemon-mode (background)
    --profile=<dir>            Store configuration files in <dir>
    --configuration=<name>     Store configuration files in directories
                               qBittorrent_<name>
    --relative-fastresume      Hack into libtorrent fastresume files and make
                               file paths relative to the profile directory
    files or URLs              Download the torrents passed by the user


Options when adding new torrents:
    --save-path=<path>         Torrent save path
    --add-paused=<true|false>  Add torrents as started or paused
    --skip-hash-check          Skip hash check
    --category=<name>          Assign torrents to category. If the category
                               doesn't exist, it will be created.
    --sequential               Download files in sequential order
    --first-and-last           Download first and last pieces first
    --skip-dialog=<true|false> Specify whether the "Add New Torrent" dialog
                               opens when adding a torrent.


Option values may be supplied via environment variables. For option named
'parameter-name', environment variable name is 'QBT_PARAMETER_NAME' (in upper
case, '-' replaced with '_'). To pass flag values, set the variable to '1' or
'TRUE'. For example, to disable the splash screen:
QBT_NO_SPLASH=1 ./qbittorrent-nox
Command line parameters take precedence over environment variables

Starting qbittorrent

Now you just run it and enjoy!

~/bin/qbittorrent-nox

Web ui

To get your external IP with the default qbittorrent command use this command:

echo $(wget -qO - icanhazip.com):8080

Second instance

When you simply call the binary using ~/qbittorrent-nox it will look for it’s configuration in ~/.config/qbittorrent.

If you would like to run a second instance using another configuration you can do so like this

~/bin/qbittorrent-nox --configuration=NAME

This will create a new configuration directory using this suffix.

~/.config/qbittorrent_NAME

You will also need a custom nginx proxypass and systemd service.

And you can now configure this instance separately.