← Package directory
Available on winget

Install cv4pve-diag

Diagnostic Tool for Proxmox VE

Install with winget
winget install --id Corsinvest.cv4pve.diag
Upgrade
winget upgrade --id Corsinvest.cv4pve.diag
Uninstall
winget uninstall --id Corsinvest.cv4pve.diag

About cv4pve-diag

cv4pve-diag is a comprehensive diagnostic tool for Proxmox VE that performs health checks and system analysis on your virtualization infrastructure. Features: - Node health and status monitoring - VM/Container diagnostics and configuration validation - Storage capacity and performance checks - Replication and backup status verification - Snapshot age monitoring - Multiple output formats (Text, HTML, JSON, Markdown) - Customizable severity thresholds - Support for ignore patterns

What's new in 2.2.4

Fixes - WS0002 (Image Orphaned) — cloud-init drives (vm-{vmid}-cloudinit) and mounted ISOs are recognised as in-use and no longer reported as orphaned. Thin provisioning calculations are unchanged: they still consider only real data disks. (#38) - WG0005 (Cdrom mounted) — cloud-init drives are no longer flagged. Real ISO mounts are still reported, with the drive id and storage:filename in the description for easier triage. (#38) - CG0002 (Disk disabled for backup) — LXC rootfs is no longer flagged when no backup= flag is set. The parser now matches Proxmox defaults: Qemu disks included unless backup=0, LXC rootfs always included, LXC mp* excluded unless backup=1. (#37) - IC0001 (Backup job no compression) — backup jobs targeting Proxmox Backup Server are no longer flagged. PBS handles compression server-side and exposes no compress option on the job. (#39) Dependencies - Updated Corsinvest API packages to 9.1.18. What's Changed - fix(IC0001): skip compression check for PBS backup jobs by @franklupo in #40 - fix: stop false positives for cloud-init / CD-ROM drives by @franklupo in #41 - chore: release 2.2.4 by @franklupo in #42 Full Changelog: v2.2.3...v2.2.4

Read release notes

Version history

Version Updated Notes
2.2.4 Unknown Fixes - WS0002 (Image Orphaned) — cloud-init drives (vm-{vmid}-cloudinit) and mounted ISOs are recognised as in-use and no longer reported as orphaned. Thin provisioning calculations are unchanged: they still consider on...
2.2.3 Unknown Fixes - CVE checks are now really disabled by default (#34) — no more unexpected calls to services.nvd.nist.gov and security-tracker.debian.org unless you enable them in settings.json. - More reliable detection of TPM 2....
2.2.2 Unknown Documentation - Documented the Sys.Modify permission requirement: Proxmox requires it even for read access to the APT update list (/nodes/{node}/apt/update). Fixes - NuGet package license metadata corrected from MIT to G...
2.2.1 Unknown Fixes - HA Groups correctly skipped on PVE 9 and later where the API endpoint was removed What's Changed - HA Groups correctly skipped on PVE 9 and later where the API endpoint… by @franklupo in #31 Full Changelog: v2.2....
2.2.0 Unknown New checks Node — CVE scanning (opt-in): - Open CVEs on installed packages (CN0014 / WN0041) — checks every installed package against the Debian security advisory feed for the detected PVE release. Packages with known op...
2.1.0 Unknown New checks Node: - Memory overcommit (WN0036) — the total RAM allocated to VMs and containers on a node exceeds the node's physical memory. This can cause system instability or unexpected VM crashes. - Bridge not VLAN-aw...
2.0.3 Unknown License change - License changed from MIT to GPL-3.0-only. New checks VM (QEMU): - CPU type 'host' with HA enabled (CQ0004) — critical when a VM uses CPU type host and is managed by HA. HA requires live migration, which...
2.0.2 Unknown New checks Node: - Disk temperature — warns when a disk temperature exceeds the configured threshold (requires SMART data). - Disk SMART errors — detects reallocated sectors, pending sectors, offline uncorrectable sector...
2.0.1 Unknown Improvements - Health score thresholds are now configurable separately for nodes (Node.HealthScore) and virtual machines/containers (Qemu.HealthScore, Lxc.HealthScore). Default thresholds: nodes warning=70, critical=80;...
1.9.0 Unknown Release notes