Proxmox VE for Home Assistant (built-in integration)

About

Proxmox VE is a built-in integration that connects Home Assistant to a Proxmox VE server over the local network. It adds binary sensors for backup status, node or guest status, and storage state such as active, enabled and shared. Sensors cover CPU, disk and memory usage, network input and output, uptime, status and backup duration. Buttons start, stop, pause, resume, suspend, reset and shut down guests, and can create a snapshot, with start, stop and suspend actions for all guests at once. An update entity reports software updates. Setup happens in the UI with either a password or an API token, and new devices appear on their own while removed ones are cleaned up.

Automatic summary of Home Assistant's source code. Something wrong? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
Set up in the UI Add it in Settings, Devices and services. Nothing to download.
Adds new devices New devices show up without setting it up again.
Cleans up devices Devices that are gone are removed by themselves.
Change settings later Its connection settings can change without removing it.
Gold quality Home Assistant's own rating of its code and setup experience.
Updated with Home Assistant Ships and updates with every Home Assistant release.

Provides

Sensors

Setting it up

It is added under Settings, Devices and services, with Add integration.

Connect to Proxmox VE

Authentication methodSelect authentication provider for your Proxmox VE server
HostThe hostname or IP address of your Proxmox VE server
PortThe port of your Proxmox VE server (default: 8006)
Use an API tokenEnable to use an API token or leave disabled to authenticate with a password
UsernameThe username for the Proxmox VE server
Verify SSL certificateWhether to verify SSL certificates. Disable only if you have a self-signed certificate

Also asked when changing the connection.

Proxmox VE credentials

PasswordThe password for the user
RealmSpecify your authentication realm
Token IDThe name given to the API token
SecretThe secret generated for the API token

Also asked when signing in again and changing the connection.

Texts from Home Assistant's source code, Apache License 2.0.

Entities

Binary sensorsBackup status, Status, Storage active, Storage enabled, Storage shared
ButtonsSuspend, Pause, Reset, Resume, Shut down, Create snapshot, Start, Start all, Stop, Stop all, Suspend all
SensorsCPU usage, Disk usage, Max CPU, Max disk usage, Max memory usage, Memory usage, Memory usage percentage, Network input, Network output, Status, Uptime, Backup duration, and 5 more
UpdatesSoftware update