Proxmox Performance plugin - Node CPU/Mem/Disk and guest status display

[Shadal18]

Proxmox Performance

Hi all,
I created a plugin to display Proxmox Performance data on your InkyPi.

It gives you a quick view of your Proxmox VE cluster's health and guest activity.

---

Repository

GitHub repository:
https://github.com/Shadal18/inkypi-proxmox-performance

---

Install

inkypi plugin install proxmox_performance https://github.com/Shadal18/inkypi-proxmox-performance

---

Features

• Shows live count of running, stopped, and other-state guests
• Shows node status (online/offline) and uptime
• Shows aggregate CPU usage across the cluster
• Shows aggregate memory usage
• Shows aggregate disk usage across all attached storage pools
• Lists VMs and LXC containers sorted by current memory usage, highest first
• Shows per-guest CPU% and memory used/total for running guests
• Color-coded status indicators for running, stopped, and other guest states
• Clean, card-based layout optimized for e-paper readability
• Optional per-guest CPU/memory stat lines
• Optional stopped-guest visibility toggle

---

Details

The plugin pulls data from the Proxmox VE REST API (/cluster/resources) and renders a compact status dashboard tailored for e-paper screens.

The display shows:

• A node status card with online/offline state and uptime
• Five stat cards: Running, Stopped, CPU%, Memory%, and Disk%
• A guest panel with horizontal bars sized relative to each guest's memory usage, sorted highest to lowest

Disk usage is calculated by summing all storage pools attached to a node rather than just the node's root filesystem, so the percentage matches what you'd see on the Proxmox dashboard's own Storage gauge instead of just the OS install disk.

You can hide stopped guests or per-guest stats if you want a shorter, more minimal list.

---

Settings

• Proxmox server URL
• TLS certificate validation (verify or disable for self-signed certificates)
• Show or hide stopped guests
• Show or hide per-guest CPU/memory stats

---

Requirements

• A reachable Proxmox VE instance with the API accessible on port 8006
• A Proxmox API token with a PVEAuditor (or higher) role granted on path /, with Propagate enabled, on both the user account and the token entity itself
• Network access from the InkyPi device to the Proxmox host

---

Notes

• Uses the Proxmox VE REST API as the data source
• API token credentials are stored as InkyPi environment keys (PROXMOX_TOKEN_ID / PROXMOX_TOKEN_SECRET), not in the plugin settings
• Read-only PVEAuditor access is all that's required; the plugin never starts, stops, or modifies guests

Screenshots

• Proxmox Performance Plugin
• Settings