winget install --id Corsinvest.cv4pve.reportAbout 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, AP...
What's new in 2.5.1
Fixes - Hostnames with dashes are kept in HTML and JSON file names. A node called pve-host01 used to produce pvehost01.html and pvehost01.json — the dash was dropped. The file name now matches the hostname you actually use. - Links between HTML pages now work. Clicking a node, VM or container in an overview table opened a 404 instead of the matching detail page. The links go to the right page again. - Two nodes with similar names no longer share the same report page. When two nodes ended up with the same file name (e.g. cc.01 and cc-01), the second one used to overwrite the first one's HTML/JSON file silently. Each section now gets its own file. What's Changed - chore: add unit tests + fix slug for hostnames with dashes by @franklupo in #56 - fix: HTML cross-section links + dedup HTML/JSON file paths by @franklupo in #57 - chore: bump version to 2.5.1 by @franklupo in #58 Full Changelog: v2.5.0...v2.5.1
Version history
| Version | Updated | Notes |
|---|---|---|
| 2.5.1 | Unknown | Fixes - Hostnames with dashes are kept in HTML and JSON file names. A node called pve-host01 used to produce pvehost01.html and pvehost01.json — the dash was dropped. The file name now matches the hostname you actually u... |
| 2.5.0 | Unknown | What's new - Health Score column on Nodes / VMs / Containers / Storages. Each row now carries a single 0–100 health number that summarises the resource's resource pressure (Node: weighted CPU/RAM/Disk; running VM/CT: wei... |
| 2.3.0 | Unknown | What's new - New JSON output format — --format Json. A third rendering alongside Excel and HTML, designed for automation, scripting and integrations. Produces a single zip containing one file per section (cluster.json, n... |
| 2.2.1 | Unknown | Fixes - EFI disk and TPM state now listed in the Disks sheet. efidisk0 and tpmstate0 were missing from the per-VM disk inventory because the underlying SDK consumed them into dedicated typed properties instead of leaving... |
| 2.2.0 | Unknown | What's new - Resilient collection — broken endpoints no longer abort the report. A single failing Proxmox API call (a storage with a corrupt RRD file, a node returning 500, missing permissions on a sub-resource) used to... |
| 2.1.0 | Unknown | Breaking changes - All formats now produce a single .zip. Excel output used to be a pair of loose files (Report_*.xlsx + Report_*.svg); it is now packed into one Report_*.zip containing report.xlsx and network-diagram.sv... |
| 2.0.1 | Unknown | Fixes - Reports no longer crash on VM/CT detail pages — a leftover code path in v2.0.0 still failed when a VM or container had a minimal config without extra fields. The detail page now renders cleanly in those cases. Th... |
| 2.0.0 | Unknown | What's new - HTML output — pick --format Html at the command line to get the report as a self-contained zipped website. Extract the zip and open index.html in any browser — works fully offline, no server needed. Built fo... |
| 1.8.1 | Unknown | Fixes - Compatibility with older PVE clusters — the /cluster/mapping/dir endpoint was added in newer Proxmox VE releases; older clusters (e.g. 8.3.x) returned 501 Not Implemented and crashed the report. The fetch now deg... |
| 1.8.0 | Unknown | What's new - Network topology diagram — every export now produces an SVG diagram next to the Excel file, with the same name. For each Proxmox node it shows the full network path from physical NICs to bonds, bridges, fire... |
| 1.7.0 | Unknown | What's new - Host file in node detail — the host name resolution table (/etc/hosts) is now included in each node's detail sheet, right after the network interfaces - Offline nodes — nodes that are offline are now skipped... |
| 1.6.0 | Unknown | Fixes - Disks sheet — storage type and usage now show correctly for VMs with disks spread across multiple storages - Nodes Networks sheet — the Node column was always empty; it now shows the correct node for each network... |
| 1.5.0 | Unknown | What's new - Response files — host, username and password can be saved in a config.rsp file and passed as @config.rsp, so you don't have to repeat credentials on every run - Generation stats in Summary — the Summary shee... |
| 1.4.0 | Unknown | What's new - Custom settings — generate a settings.json with create-settings, edit it, and pass it with --settings-file to fully control which sheets are generated - Cluster sheet can be disabled — new Cluster.IncludeShe... |
| 1.2.0 | Unknown | What's new - Network sheet — new dedicated sheet with a complete network inventory across the entire cluster: all node interfaces and all VM/CT network cards with MAC address, bridge, VLAN, IP addresses and OS info in on... |
| 1.1.0 | Unknown | What's new - HA (High Availability) — the Cluster sheet now includes HA resources, groups and current status - Resource Pools — the Cluster sheet now lists all pools with their members (VMs, CTs and storages) - SDN Ipams... |
| 1.0.0 | Unknown | Release notes |