dougiteixeira /proxmoxve

Proxmox VE Custom Integration Home Assistant

★ 997⑂ 82👁 5⑃ 435● 188▤ 51
PythonMITCreated 2022-07-15
Download: 5.3.45.3.4 ↓5.3.42026-10-12
+1
Daily
997
stars
82
forks
5
watchers
435
prs
188
issues
51
releases

README

Proxmox VE Custom Integration for Home Assistant


  
  


Proxmox VE is an open-source server virtualization environment. This integration reads its state into Home Assistant and lets you act on it — for a single node as much as for a cluster.

It began as @dougiteixeira's custom integration, built on the Home Assistant core integration and grown well beyond it; it replaces the core one when installed (what differs). Everything goes through the Proxmox API with the credentials you give it — nothing is installed on the nodes, except PVE-mods if you want hardware temperatures.

 What you get

- Cluster — nodes online, guests running, CPU and memory across the cluster; HA status, backup coverage and Ceph health with the optional cluster credentials; shared storage as one device.
- Nodes — status, CPU, memory, swap, disk, IO delay, load average, version; package updates as a Home Assistant update entity; last backup and failed tasks; replication, subscription and certificate expiry; hardware temperatures, fans and voltages via PVE-mods; physical disks with SMART; ZFS pools.
- Virtual machines and containers — status with QEMU's finer run states, CPU (own and as a share of the host), memory, disk from the guest agent, network, uptime, a file read from inside the guest.
- Storage — capacity and the active/enabled/shared flags, per node for local storage and once for shared.
- Actions — start, stop, shutdown, reboot, suspend, resume, hibernate, reset, unlock, snapshot and backup buttons; bulk start/stop/suspend/backup per node; Wake on LAN; arm/disarm HA; and a proxmoxve.backup action with all of vzdump's options.
- Behaviour — optional automatic discovery of everything the credentials can see, failover to another cluster node when the configured one goes down, no re-authentication after a node was off overnight, repairs that name the missing privilege, and buttons only where the privilege exists.

Many entities are created disabled by default — the buttons that change things, and sensors most setups never need — and are enabled per entity, see Disabled entities.

 Documentation

- Entities — every sensor, by cluster, node, guest and storage
- Actions — buttons and the proxmoxve.backup action
- Hardware sensors and physical disks — PVE-mods, SMART, when readings come and go
- Proxmox permissions — roles, group, user and token, step by step
- How it behaves — discovery, failover, nodes that are off, disabled entities, what I cannot test
- Troubleshooting — debug logging, diagnostics, screenshots
- Compared with the core integration — what the extra install gets you, feature by feature
- Blueprints — a scheduled backup as a ready-made automation
- Contributing

 Install

 Installation via HACS

Have HACS installed, this will allow you to update easily.

 Adding Proxmox VE to HACS can be using this button:



If the button above doesn't work, add https://github.com/dougiteixeira/proxmoxve as a custom repository of type Integration in HACS.

 Click Install

Top issues

Discussions

Latest release

5.3.4 5.3.4 2026-10-12
Fixed

- A node that cannot be read no longer takes every other entity with it. The device description read a processor name that had never been assigned, and the resulting error failed the setup of the sensor and binary sensor platforms — so one unreadable node cost the entry all of its entities, the cluster's included. Thank you, @bilogic, for the log that showed it (712).
- Saving Add or remove Nodes, VMs, Containers or Storages no longer deletes the node's disk and pool devices. The switch for physical disks moved to the Advanced configuration page in 5.2.0, and the selection step kept rea

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON