Proxmox Panel

Features

• Nodes: each node with its CPU, RAM and disk rings (the last 24 hours of CPU and RAM drawn behind them), uptime, CPUs, Proxmox VE version, pending update, how many virtual machines and containers run, and the node-wide actions (start all, suspend all, stop all, restart, shut down)
• VMs and Containers: one row per machine with its status, CPU, RAM and uptime, and the action that fits (start a stopped one, restart or shut down a running one, resume a suspended one); its name unfolds the details (RAM, disk, network download / upload, CPUs) and every other action that fits its status, with a link to the machine in the Proxmox web interface. Search by name or ID, filter by node
• Storage: one gauge per storage (green, amber from 75 %, red from 90 %), with used, free and total space, and its active and shared state
• Backups: the last backup of each node, how long it took and whether it failed, and a manual Snapshot of each virtual machine and container
• Confirmation before the actions that stop or restart something (stop, shut down, reset, restart, hibernate, node-wide actions), at the top of the list
• Settings: stopped machines shown or not, the confirmation, inactive storage hidden
• Administrators only: the panel and its commands are kept for administrators
• Cards for your dashboards, seen by every user: a node card (proxmox-card) and its mini card, a virtual machine or container card (proxmox-guest-card) and its mini card, with the visual editor; their actions are offered to administrators only
• The Proxmox logo as the sidebar icon
• Light and dark themes, phones and desktops, 22 languages
• No connection to Proxmox of its own: the panel reads the entities of the Proxmox VE integration and presses its buttons, with the permissions you gave it

Supported integrations

Prerequisites

Home Assistant 2026.11 or later, and the Proxmox VE integration added with your Proxmox server (Settings → Devices & services → Add integration → Proxmox VE). The actions need the matching permissions on the Proxmox user or token (VM.PowerMgmt, VM.Snapshot, Sys.PowerMgmt): the integration only creates the buttons it is allowed to press.

The backup sensors of the nodes (last backup, duration, status) are disabled by default in the Proxmox VE integration: enable them on the node's device to see the backups in the panel. The Backups tab links to the device when they are off.

Panel

The Proxmox entry of the sidebar, at /proxmox (each tab has its own address: /proxmox/vms, /proxmox/containers, /proxmox/storage, /proxmox/backups, /proxmox/settings). It is for administrators only: other users do not see it in the sidebar, and its commands refuse them.

Settings#

Cards

Four Lovelace cards come with the integration: nothing to install separately. Every user sees them; their buttons (start, shut down, restart, snapshot…) are shown to administrators only, and the actions that stop or restart something ask for a confirmation at the top of the card, as in the panel. Each card has a visual editor; in YAML:

Node card#

type: custom:proxmox-card
node: pve1          # a node, by name; all: every node, one after the other; left out: the first one

Node mini card#

type: custom:proxmox-mini-card

One line per node with its CPU, RAM and disk bars and the machines running (node: keeps one, then its counts become the subtitle). The round button at the top right (zoom: false removes it) shows the node card in its place, with the same options; a click anywhere outside the card brings the compact view back. Options: node, zoom, show_title, show_subtitle, language, and those of the node card for the zoomed view.

Virtual machine or container card#

type: custom:proxmox-guest-card
guest: 102          # a VMID; guests: [100, 202] stacks several machines

A running machine shows its CPU, RAM and disk rings (24-hour curves behind CPU and RAM); a stopped one its CPUs, RAM and disk size.

Virtual machine or container mini card#

type: custom:proxmox-guest-mini-card
guests: [102, 202, 101]

One line per machine: CPU and RAM bars while it runs, else its status and a quick Start or Resume (administrators). The zoom button shows the full card in its place. Options: those of the machine card, and zoom.

How it works

The Proxmox VE integration creates one device per node, virtual machine, container and storage. The panel's integration reads the device and entity registries and tells the panel which entity is which: each device is recognized by its identifier (<entry>_node_<id>, <entry>_vm_<vmid>, <entry>_container_<vmid>, <entry>_storage_<name>), and each entity by the end of its unique ID (node_cpu, vm_memory, start, snapshot_create…), so renamed entities and entity IDs in another language are supported. Disabled entities are reported too, which is how the Backups tab knows that the backup sensors are off.

The cards get the same inventory from a command every user may call (proxmox_panel/cards), kept 5 minutes for every card of the page: it names the entities, whose values any user can already read in their states.

The panel and the cards then read the states as Home Assistant updates them (every 60 seconds by default in the Proxmox VE integration), and an action is a press of the matching button entity (button.press). The 24-hour curves come from the recorder's history of the nodes' CPU and RAM sensors. Several Proxmox VE servers (several entries) are shown together, with a node filter.

Sizes are shown in base 1024 (KiB, MiB, GiB, TiB) with 2, 1 or 0 decimals as the value grows, percentages as whole numbers, and download in green, upload in blue, as in the other ha-* projects.

Trademark

Proxmox® is a registered trademark of Proxmox Server Solutions GmbH. This project is not affiliated with or endorsed by Proxmox Server Solutions GmbH; the logo is used to identify the integration it works with.

Support

If you find this project useful, you can support its development:

First stable release.

Features

• Cards for the dashboards, added to the resources by the integration, with a visual editor and 22 languages:
  • proxmox-card: a node (or every node with node: all) with its CPU, RAM and disk rings and 24-hour curves, uptime, version and pending update, its virtual machines and containers (running first, max_items per list) and its storage gauges;
  • proxmox-mini-card: one line per node with CPU, RAM and disk bars and the machines running, its zoom button showing proxmox-card;
  • proxmox-guest-card: one or several virtual machines or containers (guest / guests), with their rings, network and the actions that fit their status;
  • proxmox-guest-mini-card: one line per machine, a quick Start or Resume, its zoom button showing proxmox-guest-card.
• Every user sees the cards; their actions are offered to administrators only, and those that stop or restart are confirmed at the top of the card (the panel's setting).
• New proxmox_panel/cards command, open to every user, giving the cards the inventory.

Changes

• The panel and the cards share proxmox-common.js; the panel's ring labels show the sizes on a line of their own.

Changes

• The panel is for administrators only, always: the Keep the panel for administrators setting is gone, the panel is registered for administrators and its commands refuse other users. An installation that had opened it to everyone gets it back for administrators only after the update.

Features

• First release: a Proxmox sidebar panel over the built-in Proxmox VE integration, with the Proxmox logo as its icon.
• Nodes tab: CPU, RAM and disk rings with 24-hour curves, uptime, CPUs, Proxmox VE version, pending update, machines running and node-wide actions.
• VMs and Containers tabs: status, CPU, RAM, uptime and quick action per machine; unfolded details (RAM, disk, network, CPUs) with every action that fits its status; search and node filter.
• Storage tab: usage gauges with used, free and total space, active and shared state.
• Backups tab: last backup, duration and status of each node (with a link to enable the backup sensors when they are off), and a manual snapshot of each machine.
• Settings tab: stopped machines shown or not, confirmation of the actions that stop or restart, panel kept for administrators, inactive storage hidden.
• 22 languages.