______ _ __
/ ____/___ __________(_)___ _ _____ _____/ /_
/ / / __ \/ ___/ ___/ / __ \ | / / _ \/ ___/ __/
/ /___/ /_/ / / (__ ) / / / / |/ / __(__ ) /_
\____/\____/_/ /____/_/_/ /_/|___/\___/____/\__/
Report Tool for Proxmox VE (Made in Italy)
The RVTools for Proxmox VE: reads your whole cluster through the API and exports it to Excel, a static HTML site or JSON, with a network diagram.
Prefer a web interface with the history of your reports? cv4pve-report also runs inside cv4pve-admin, as its System Report module.
The Proxmox VE web interface shows one object at a time. When someone asks how many VMs do we run, on which nodes, with how much memory, and who can log in? (an auditor, a customer taking over the cluster, a capacity plan, a migration from VMware) there is no single place to look.
cv4pve-report reads the whole cluster (nodes, VMs, containers, storage, network, firewall, replication, HA, SDN, users and tokens) and writes it down in one file you can filter, share and keep. Coming from VMware? See where each RVTools tab lives.
It runs outside the nodes and uses only the Proxmox VE API: nothing to install on the cluster, no SSH, no root shell.
A few rows and columns of the Storages and VMs sections:
| Node | Storage | Status | Health | Plugin Type | Shared | Disk Size GB | Disk Usage GB | Disk Usage % |
|----------|-----------|-----------|--------|-------------|--------|--------------|---------------|--------------|
| (shared) | pbs01 | available | 19 | pbs | X | 3000.00 | 2427.45 | 80.91% |
| pve01 | datapool | available | 80 | zfspool | | 5068.38 | 1015.68 | 20.04% |
| pve02 | local-zfs | available | 64 | zfspool | | 214.09 | 77.82 | 36.35% |
| Node | Vm Id | Name | Status | Health | Cpu Size | Memory Size GB | Memory Usage % | Os Version | Agent Running |
|-------|-------|-------------|---------|--------|----------|----------------|----------------|--------------------------------|---------------|
| pve02 | 203 | test-debian | stopped | | 2 | 4.00 | 0.00% | Linux 5.x - 2.6 Kernel | |
| pve01 | 1006 | dc01 | running | 66 | 4 | 8.00 | 65.09% | Windows Server 2022 Datacenter | X |
| pve01 | 1104 | gitlab | running | 48 | 4 | 10.00 | 95.03% | Ubuntu 22.04.5 LTS | X |
Every node, VM and container links to its own sheet or page. Health is a 0-100 score of how loaded the resource is: higher is healthier. Every table and column is described in Sections.
- Three formats: an Excel workbook with real Excel tables, an offline HTML site, or one JSON file per section.
- Network diagram: every export includes an SVG of each node: NICs, bonds, bridges, the VMs and containers behind them, network storages.
- Profiles:
--fastfor a quick inventory of a large cluster,--fullfor audits and capacity planning: SMART, syslog, cluster log, a week of RRD history, average and peak usage of every guest and node. - Your own selection: a settings file turns each section on or off; guests by ID, range, name, node, pool or tag.
- Nothing silently missing: a call that fails lands on an Issues page with the Proxmox error, and the rest of the report is still written.
- Diff-friendly: every table is sorted, so two reports of an unchanged cluster differ only in live values.
- Tested at scale: a production cluster of 25 nodes and about 2700 VMs reports in about 7 minutes.
- Keeps running with a node down: give it more than one host and it uses the first that answers.
# Windows
winget install Corsinvest.cv4pve.report
# Linux (other platforms and packages: see the documentation)
wget https://github.com/Corsinvest/cv4pve-report/releases/latest/download/cv4pve-report-linux-x64.zip
unzip cv4pve-report-linux-x64.zip && chmod +x cv4pve-report
# Run against any node of the cluster, with an API token
./cv4pve-report --host=pve01 --api-token='report@pve!report=<uuid>' exportThe report is a .zip in the current folder. The API token needs the privileges listed in Permissions. Note that PVEAuditor alone cannot list backups.
| Getting started | Install, connect, run |
| Coming from RVTools | Where each RVTools tab lives in the report |
| Permissions | Creating the user and API token, required privileges |
| Output | Excel, HTML, JSON, network diagram, Health Score |
| Sections | Every table and column |
| AI assistants | Claude Code, Codex, the cv4pve-report skill |
| Settings | Profiles, settings file, guest selection, performance |
| Troubleshooting | The Issues page, and what the tool is doing when something goes wrong |
Use cv4pve-report to know what you have, cv4pve-diag to know what is wrong. The whole suite: corsinvest.it/cv4pve.
Professional support and consulting available through Corsinvest.
By sysadmins, for sysadmins.
Part of cv4pve suite | Made with ❤️ in Italy by Corsinvest
Proxmox® is a registered trademark of Proxmox Server Solutions GmbH. cv4pve is developed by Corsinvest and is not a Proxmox product.
Copyright © Corsinvest Srl