How to Set Up the qBittorrent Web UI on Linux

To set up the qBittorrent Web UI on Linux, install qbittorrent-nox, start it once as a non-root user, then sign in through a browser. The first launch prints the Web UI address and login details. Set a strong password before leaving the service online. For remote access, use an SSH tunnel or HTTPS proxy instead of exposing the default HTTP port to the public internet.

1. Install qbittorrent-nox

The headless qbittorrent-nox package runs without a desktop window and is controlled in a browser. Install it from your distribution’s package manager:

• Ubuntu or Debian: sudo apt update && sudo apt install qbittorrent-nox
• Fedora: sudo dnf install qbittorrent-nox
• Arch Linux: sudo pacman -S qbittorrent-nox

Ubuntu packages are in the Universe component; enable it if APT cannot find the package. Package versions vary by release. Check the official Ubuntu, Debian, Arch, or Fedora package catalog if the package is unavailable. The upstream installation guide explains package and version options.

2. Start qBittorrent as a regular user

Do not run the client with sudo. qBittorrent stores settings and downloads for the account that starts it. For a quick test, use your normal non-root account. On a server, use a dedicated account such as qbtuser; create it with sudo adduser qbtuser or, where available, sudo useradd -m -s /bin/bash qbtuser. Initialize the client under that same account:

sudo -iu qbtuser
qbittorrent-nox

Accept the legal notice when prompted. qBittorrent prints the Web UI URL, usually http://localhost:8080, and the administrator username. Current releases with no saved password print a temporary random password in the terminal. Some older packages may still show adminadmin; use the value your version prints and change any default password immediately.

3. Sign in and change the password

On the Linux machine, open the printed address in a browser and sign in as admin. If the client runs on a headless server, connect through SSH as described below. In Settings or Preferences → Web UI, set a unique, strong password. Keep port 8080 unless it is already in use. For a localhost-only setup, bind the Web UI to 127.0.0.1, then save the change.

4. Connect remotely with an SSH tunnel

The Web UI uses HTTP by default, so a direct public port forward can expose your login. From your computer, open an SSH tunnel to the Linux server:

ssh -L 8080:127.0.0.1:8080 linux_user@server_address

Keep that terminal session open and visit http://127.0.0.1:8080 on your computer. For access without SSH, use a VPN or configure TLS termination with a reverse proxy. qBittorrent’s Linux HTTPS and NGINX guide covers one supported approach. Do not disable authentication or expose the Web UI to untrusted networks.

5. Keep it running with systemd

After saving the initial settings, stop the foreground process with Ctrl+C, then exit the account shell. Many distribution packages include the qbittorrent-nox@.service template. Enable it for the account used above and check its status:

sudo systemctl enable --now qbittorrent-nox@qbtuser
sudo systemctl status qbittorrent-nox@qbtuser

Replace qbtuser if you chose another account. If the unit is missing, follow the upstream systemd setup guide for your distribution. For a temporary background run without boot management, use qbittorrent-nox -d.

6. Add torrents and find downloaded files

In the Web UI, click Add Torrent or the plus icon. Choose a .torrent file or select the magnet-link option and paste a magnet URI. Confirm the save path before starting the task, and only add content you are authorized to download or share.

The Linux host downloads the data; it does not go to the device displaying the browser. Check the configured save path in the download settings. A service account’s files are stored under that account’s paths, not necessarily your personal home directory. Use SSH, SFTP, or a shared folder to retrieve them. When removing a completed torrent, read the confirmation and choose whether to keep or delete its data.

Troubleshooting

• The page will not load: Check sudo systemctl status qbittorrent-nox@qbtuser, confirm the port in Settings, and verify that the tunnel uses the same port.
• The login fails: Check startup output or the service log with sudo journalctl -u qbittorrent-nox@qbtuser -n 50 --no-pager. Use the same Linux account that owns the qBittorrent configuration. See the project’s password recovery guide if you are locked out.
• Port 8080 is busy: Pick another port in Web UI settings, or test with qbittorrent-nox --webui-port=8081. Update the browser URL and SSH tunnel. The qbittorrent-nox manual lists command-line options.