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 Proxmox VE Exporter logo

Self-host Prometheus Proxmox VE Exporter

v3.10.2

Prometheus exporter for Proxmox VE cluster metrics

ReleaseOpen SourceApache-2.0
Updated6 hours ago
LanguagePython
Setup difficultyModerate
Stars
1 485
Port
9221 (HTTP metrics endpoint)
Docker
prompve/prometheus-pve-exporter
Install with Docker

What is Prometheus Proxmox VE Exporter?

Prometheus Proxmox VE Exporter is a self-hosted, open-source exporter that connects to Proxmox VE clusters via their API and exposes metrics for Prometheus monitoring. It collects node, VM, and container status; CPU, memory, disk, and network usage; storage information; HA state; replication status; subscription info; and QDevice state. The exporter can run directly on a Proxmox node or on a separate machine, configured via a YAML file or environment variables for password or token authentication. It is deployed via Docker (prompve/prometheus-pve-exporter) or pip, requires Python 3.9+, and listens on port 9221 by default. The project is actively maintained with regular releases.

Should you self-host Prometheus Proxmox VE Exporter?

Prometheus Proxmox VE Exporter scores 58/100 on selfhost.directory (how scoring works) and ranks #11 of 51 in Monitoring & observability. It has 1 485 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v3.10.2, came out on 26 October 2026. New versions land roughly every 5 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is GoAccess (75/100, 21 091 stars). It scores higher overall, so compare the two before you pick. See Prometheus Proxmox VE Exporter vs GoAccess side by side.

Features

  • Backup Coverage
  • Cluster Information
  • Node Information
  • Node/VM/CT Status Collection
  • Onboot Status
  • Password Authentication
  • PVE API Metrics
  • PVE Version Info
  • QDevice State
  • Replication Info
  • Resources Information
  • SSL/TLS support
  • Subscription Info
  • Target Scrape Metrics
  • Token Authentication

Prometheus Proxmox VE Exporter README

How to install Prometheus Proxmox VE Exporter

Install Prometheus Proxmox VE Exporter with Docker

Docker Engine
Environment variables
PVE_USER, PVE_PASSWORD, PVE_TOKEN_NAME, PVE_TOKEN_VALUE, PVE_VERIFY_SSL, PVE_MODULE

docker pull prompve/prometheus-pve-exporter docker run --init --name prometheus-pve-exporter -d -p 127.0.0.1:9221:9221 -v /path/to/pve.yml:/etc/prometheus/pve.yml prompve/prometheus-pve-exporter

Mount config file at /etc/prometheus/pve.yml

How to configure Prometheus Proxmox VE Exporter

  • config.file/etc/prometheus/pve.ymlPath to config file

    Path to config file

  • PVE_MODULEdefaultName of the configuration module

    Name of the configuration module

  • PVE_PASSWORDProxmox VE user password for password authentication

    Proxmox VE user password for password authentication

  • PVE_TOKEN_NAMEProxmox VE API token name for token authentication

    Proxmox VE API token name for token authentication

  • PVE_TOKEN_VALUEProxmox VE API token value for token authentication

    Proxmox VE API token value for token authentication

  • PVE_USERProxmox VE user name for authentication

    Proxmox VE user name for authentication

  • PVE_VERIFY_SSLtrueWhether to verify PVE TLS certificate (true/false)

    Whether to verify PVE TLS certificate (true/false)

    values: true|false

  • server.certfileSSL certificate for server

    SSL certificate for server

  • server.keyfileSSL key for server

    SSL key for server

  • web.listen-address[::]:9221Address on which to expose metrics and web server

    Address on which to expose metrics and web server

Prometheus Proxmox VE Exporter releases & version history

More in Monitoring & observability

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…