selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
prometheus-qbittorrent-exporter logo

Self-host prometheus-qbittorrent-exporter

1.7.1

Prometheus exporter for qBittorrent metrics

ReleaseOpen SourceGPL-3.0
Updated9 hours ago
LanguagePython
Setup difficultyEasy
Stars
197
Port
8000 (Prometheus metrics endpoint)
Requires
qBittorrent
Docker
ghcr.io/esanchezm/prometheus-qbittorrent-exporter
Install with Docker
Grafana dashboard showing qBittorrent metrics including torrent counts, download/upload rates, and network connectivity

What is prometheus-qbittorrent-exporter?

prometheus-qbittorrent-exporter is a Python-based Prometheus exporter that connects to a qBittorrent server and exposes its metrics in Prometheus format. It collects data such as torrent counts by category and status, download/upload statistics, DHT nodes, peer connections, and server connectivity status. The exporter can be installed via pip or run as a Docker container from ghcr.io. Configuration is done through environment variables for the qBittorrent connection details, exporter listening address and port, log level, and metrics prefix. It requires a running qBittorrent instance with WebUI enabled. The project is licensed under GPL-3.0 and includes a Grafana dashboard for visualization.

Should you self-host prometheus-qbittorrent-exporter?

prometheus-qbittorrent-exporter scores 46/100 on selfhost.directory (how scoring works) and ranks #73 of 104 in Monitoring & observability. It has 197 GitHub stars.

It shipped 2 stable releases in the past year. The latest, 1.7.1, came out on 25 October 2026. New versions land roughly every 5 months.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is grafana (90/100, 77 568 stars). It scores higher overall, so compare the two before you pick. See prometheus-qbittorrent-exporter vs grafana side by side.

Features

  • API Key Authentication
  • Configurable log level
  • Configurable metrics prefix
  • Grafana Dashboard
  • Network connectivity metrics
  • Prometheus metrics export
  • SSL/TLS support
  • Torrent statistics

prometheus-qbittorrent-exporter README

How to install prometheus-qbittorrent-exporter

Install prometheus-qbittorrent-exporter with Docker

Environment variables
QBITTORRENT_HOST, QBITTORRENT_PORT, QBITTORRENT_SSL, QBITTORRENT_URL_BASE, QBITTORRENT_USER, QBITTORRENT_PASS, QBITTORRENT_API_KEY, EXPORTER_ADDRESS, EXPORTER_PORT, EXPORTER_LOG_LEVEL, METRICS_PREFIX, VERIFY_WEBUI_CERTIFICATE

docker run
-e QBITTORRENT_PORT=8080
-e QBITTORRENT_HOST=myserver.local
-p 8000:8000
ghcr.io/esanchezm/prometheus-qbittorrent-exporter

Requires qBittorrent server with WebUI enabled

How to configure prometheus-qbittorrent-exporter

  • EXPORTER_ADDRESS0.0.0.0Exporter listening IP address

    Exporter listening IP address

  • EXPORTER_LOG_LEVELINFOLog level. One of: `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`

    Log level. One of: `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`

  • EXPORTER_PORT8000Exporter listening port

    Exporter listening port

  • METRICS_PREFIXqbittorrentPrefix to add to all the metrics

    Prefix to add to all the metrics

  • QBITTORRENT_API_KEY""qBittorrent API key for qBittorrent >= 5.2. When set, it overrides `QBITTORRENT_USER`/`QBITTORRENT_PASS`.

    qBittorrent API key for qBittorrent >= 5.2. When set, it overrides `QBITTORRENT_USER`/`QBITTORRENT_PASS`.

  • QBITTORRENT_HOSTqbittorrent server hostname

    qbittorrent server hostname

  • QBITTORRENT_PASS""qbittorrent password

    qbittorrent password

  • QBITTORRENT_PORTqbittorrent server port

    qbittorrent server port

  • QBITTORRENT_SSLFalseWhether to use SSL to connect or not. Will be forced to `True` when using port 443

    Whether to use SSL to connect or not. Will be forced to `True` when using port 443

  • QBITTORRENT_URL_BASE""qbittorrent server path or base URL

    qbittorrent server path or base URL

  • QBITTORRENT_USER""qbittorrent username

    qbittorrent username

  • VERIFY_WEBUI_CERTIFICATETrueWhether to verify SSL certificate when connecting to the qbittorrent server. Any other value but `True` will disable the verification

    Whether to verify SSL certificate when connecting to the qbittorrent server. Any other value but `True` will disable the verification

prometheus-qbittorrent-exporter releases & version history

More in Infrastructure Monitoring

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…