Skip to content

Running qBittorrent without X server (WebUI only)

Francisco Pombal edited this page May 4, 2020 · 2 revisions


On Linux, the qbittorrent-nox package includes a version of qBittorrent that does not require any GUI-related components to run, ideal to run in headless server environments. It can be controlled via a feature rich HTTP WebAPI and WebUI.

You can install it from a binary package repository such as your distro's repositories, the official Ubuntu PPAs, etc.

You can also compile it from source by toggling the flag that disables the GUI (refer to the relevant compilation guides on the wiki).


Simply execute qbittorrent-nox. At first execution, you should get prompted to accept the legal disclaimer. After that, qBittorrent will print out some useful information, such as the URL the WebAPI/WebUI can be accessed at, via a web browser, and the default credentials.

To quit, simply press Ctrl-c or send SIGINT or SIGTERM to the process.

Running in the background

After first start and having accepted the legal disclaimer, you can also use qbittorrent-nox -d to execute qbittorrent as a daemon in the background, instead of running it in the foreground.

You probably want to control the daemon, like setting it to start on system boot, for example. To learn how to do that with systemd on Ubuntu 15.04 and other modern releases of mainstream distros, check out the dedicated article.

Settings and logs

Settings can be customized via the WebUI, WebAPI, or, if needed, manually editing the config file when qBitorrent is not running (`~/.config/qBittorrent/qBittorrent.conf).

The logs as well as other program data are located in ~/.local/share/data/qBittorrent.

Consult the man page or pass --help for more information.



External programs

Search plugins





State Version
Current qBittorrent ≥ v4.1
Previous qBittorrent v3.2.0 - v4.0.x
Obsolete qBittorrent < v3.2.0

WebAPI clients

Alternate WebUI

Reverse proxy setup for WebUI access

WebUI HTTPS configuration




Common information for CMake

*BSD, Linux



Obsolete compilation guides

Clone this wiki locally