Need Help?

Need help to install or setup this app? We are available on:

Discord

Setting Up qBittorrent

Setting Up qBittorrent on Nébulaura

qBittorrent is an open-source BitTorrent client written in C++, designed to be a lightweight and efficient alternative to other torrent clients.

Initial Setup

To install qBittorrent on your slot, use the following command:

box install qbittorrent

This will install a tuned qBittorrent client configured for optimal performance.

How to Access

Access the qBittorrent web GUI by appending /qbittorrent to your hostname:

https://<hostname.io>/qbittorrent/

Service Management

As with all Nébulaura-configured applications, qBittorrent can be managed via SSH using the following commands:

  • Status: Check the current status of qBittorrent.
  • Start: Start the qBittorrent service.
  • Stop: Stop the qBittorrent service.
  • Restart: Restart the qBittorrent service.
  • Enable: Configure qBittorrent to start automatically at boot.
  • Disable: Prevent qBittorrent from starting at boot.

Example:

box start qbittorrent

Connecting to Other Software

External Services

To connect qBittorrent with external services, you may need to adjust its Web UI settings:

  1. Open the Web GUI at https://<hostname.io>/qbittorrent/.
  2. Click the Settings gear icon in the top-left menu.
  3. Navigate to Web UI and:
    • Change the bind IP address to * (for all IPs).
    • Copy the Web UI port.

You can now connect to qBittorrent via:

http://<hostname.io>:<qbittorrent-port>

⚠️ Caution: If you change the password, ensure it is secure. This configuration exposes your client to the internet without the default safety measures.

Mobile Applications (Transdroid/Transdrone)

To connect qBittorrent to Transdroid/Transdrone, use the following settings:

  • Name: qBittorrent (or any preferred name)
  • Server Type: qBit
  • IP or Hostname: <hostname.io>
  • Username: <your username>
  • Password: <your password>
  • Advanced Settings:
    • Port: 443
    • Folder: /qbittorrent
    • Use SSL: ON

Command Line Tools

qBittorrent CLI

A powerful CLI tool written in Go for managing qBittorrent. Features include adding torrents, reannouncing torrents, setting download limits, and importing torrents from other clients.

Installation

curl $(curl -sNL https://api.github.com/repos/ludviglundgren/qbittorrent-cli/releases/latest | grep -Po 'ht(.*)linux_amd64(.*)tar.gz') -L -o /tmp/qbittorrent-cli.tar.gz
tar -xvf /tmp/qbittorrent-cli.tar.gz --exclude={CHANGELOG.md,README.md} -C ~/bin/

qbittools

A feature-rich CLI for torrent management with options for adding, unpausing, tagging, and exporting torrents.

Installation

curl -Ls https://gitlab.com/AlexKM/qbittools/-/raw/master/install.sh | bash -s -- -o ~/bin/qbittools

⚠️ Note: These tools are not officially supported. For assistance, reach out to the Nébulaura community on Discord.

Troubleshooting

To troubleshoot qBittorrent, view the logs:

less -r +G ~/.local/share/qBittorrent/logs/qbittorrent.log

To exit the log viewer, press q.

Efficient Torrent Management

With qBittorrent on Nébulaura, you gain access to a fast and lightweight torrent client optimized for your needs. Set it up today for seamless torrent management.