cv4pve-report

cv4pve-report 2.9.0

Report Tool for Proxmox VE

  • By Corsinvest Srl
  • Open Source
  • Updated Oct 2, 2026
Download for Windows

About cv4pve-report

cv4pve-report exports your entire Proxmox VE infrastructure to a single
navigable Excel file — nodes, VMs, containers, storages, users, firewall
rules, backup jobs, resource pools and more. Every row is a hyperlink to
its detail sheet.

Features:

  • Single .xlsx file with one sheet per node, VM and storage
  • Fully navigable — summary rows link to detail sheets
  • Cluster: users, API tokens, TFA, groups, roles, ACL, firewall, backup jobs, replication, SDN, pools
  • Nodes: services, network, disks, SMART, RRD metrics, APT updates, SSL certificates, tasks
  • VMs/CTs: config, network, disks, RRD metrics, backups, snapshots, firewall, QEMU agent info
  • Storages: content inventory, RRD metrics
  • Three profiles: Fast, Standard, Full
  • Works with a read-only API token, no root access required

What's new in 2.9.0

What's new
- Capacity Planning section. One row per guest, node and storage with the numbers a sizing starts from: what is allocated, what is used on average, what is used at the peak, and how fast each storage fills up. No metric server or Grafana needed: it is built on the RRD data the nodes already keep (#85).
- Guests: vCPUs, CPU average and peak (% and cores), memory size, average and peak, disks size and used, network average and peak.
- Nodes: the same usage columns, plus the vCPUs and the memory assigned to the running guests with their ratio to the node (above 1 the node is overcommitted).
- Storage: size, used, free, growth per day and days to full.
- Averages come from the RRD samples read with the Average consolidation, peaks from a second read with Maximum: the highest of the averaged samples is not the peak. One more API call per guest and per node, only when the section is on.
- Turned on by the new setting CapacityPlanning.Enabled: off by default, on with --full. Each table needs the RrdData.Enabled of its scope (guests, nodes, storage) and uses its time frame.
- It is a summary, so it comes first: after Summary and Issues in Excel and in the Contents table, under Network Diagram in the HTML sidebar. JSON: capacity-planning.json, and filters.capacityPlanning in metadata.json.
Changed
- Documentation: new Capacity Planning page; Disks, Partitions and Snapshots moved from the VMs & containers page to the Storage page, as in the sidebar of the HTML report.
What's Changed
- docs: home page title for search results by @franklupo in #83
- docs: theme 2.6.2 by @franklupo in #84
- feat: Capacity Planning section with average and peak usage by @franklupo in #86
- chore: release 2.9.0 by @franklupo in #87
Full Changelog: v2.8.1...v2.9.0

Full release notes »

Technical details

PublisherCorsinvest Srl
Version2.9.0
Release date2026-10-02
LicenseGPL-3.0
Installer typezip
Architecturex86, x64, arm64
Package IDCorsinvest.cv4pve.report

Links & install command

Install cv4pve-report from the command line with Windows Package Manager (winget):

winget install --id=Corsinvest.cv4pve.report -e

corsinvestexcelinfrastructureinventoryproxmoxproxmoxvereportxlsx

Older versions

  • 2.8.1
  • 2.5.1
  • 2.5.0
  • 2.3.0
  • 2.2.1
  • 2.2.0
  • 2.1.0
  • 2.0.1
  • 2.0.0