qBittorrent integration
Purpose
qBittorrent is the primary download manager documented in PlexSub's service registry. It shows the queue, download ownership, and status in the Customer Portal.
It appears in PlexSub at:
- Admin:
/qbittorrent - Customer Portal: downloads
Requirements
- qBittorrent Web UI enabled.
- A URL reachable from PlexSub.
- A username and password.
Related variables: QBITTORRENT_URL, QBITTORRENT_USERNAME, and QBITTORRENT_PASSWORD.
Recommended configuration
- Enable Web UI in qBittorrent.
- Confirm that you can sign in from a browser.
- Configure the URL, username, and password in PlexSub.
- Run diagnostics.
- Check that the portal shows downloads only when data is available.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| Login failed | Incorrect username or password | Check credentials. |
| Cannot connect | Web UI unreachable from Docker | Check host, port, and firewall. |
| Downloads do not appear | Insufficient mapping or an empty queue | Check the queue and user association. |
| Session expired | qBittorrent rejects the session | Save credentials again and run diagnostics. |