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.3.0
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, nodes.json, vms.json, storages.json, …) plus per-resource detail under nodes/<name>.json, vms/<id>.json and containers/<id>.json, same logical layout as the Excel sheets and HTML pages. A metadata.json carries the schema version, timestamp, application info, the filter set and a per-section generation log. The network topology SVG is bundled in the same zip as network-diagram.svg. Keys are camelCase with stable shapes (overview files are flat arrays of rows; detail files are objects with a fixed info block plus one entry per table), so consumers can navigate the dataset without knowing resource names in advance. Full reference in docs/format-json.md with file layout, naming conventions, jq recipes and a snapshot-diff workflow. - CD-ROM and cloud-init drives now listed in the Disks sheet. The per-VM disk inventory used to skip ide2-style CD-ROMs and cloudinit drives, only showing real block devices. They now appear alongside the rest with a new Kind column (Disk, CDRom, CloudInit) so you can filter on what's actually a backed-up disk vs. a transient mount. Thanks for the report (#39). What's Changed - feat: include CD-ROM and cloud-init drives in the Disks sheet by @franklupo in #39 - feat: JSON output format (--format Json) by @franklupo in #40 - chore: bump version to 2.3.0 by @franklupo in #41 Full Changelog: v2.2.1...v2.3.0
Version history
| Version | Updated | Notes |
|---|---|---|
| 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 |