Proxmox Extended Sensors for PVE and PBS inside Home Assistant

Share your Projects! Custom Integrations
1

:jigsaw: New Integration: Proxmox Extended Sensors

:link: GitHub Repository

Captura de pantalla 2026-01-23 092659
Captura de pantalla 2026-01-23 092659880×860 93.7 KB

Advanced monitoring and maintenance actions for PVE and PBS inside Home Assistant

Hello everyone,

I’d like to introduce Proxmox Extended Sensors, an integration designed to provide a more complete, structured, and powerful experience when working with Proxmox VE and Proxmox Backup Server from within Home Assistant.

This project was created to complement and extend the existing capabilities, adding advanced metrics, detailed sensors, and new features aimed at improving daily administration of Proxmox environments.

:mag: What does this integration offer?

:heavy_check_mark: Advanced monitoring for PVE

  • Sensors for CPU, RAM, storage, node status, and VM/CT status
  • Network RX/TX sensors for virtual machines and containers
  • Clean device grouping for a clear and organized UI

:heavy_check_mark: Direct actions on VMs and CTs

Buttons for:

  • Start
  • Shutdown
  • Stop
  • Reboot
  • Reset
  • Suspend / Resume
  • Hibernate (when supported)

All accessible directly from Home Assistant without opening the Proxmox interface.

:shield: PBS integration and maintenance tools

:heavy_check_mark: New maintenance buttons

Trigger PBS maintenance tasks directly from Home Assistant:

  • Garbage Collect
  • Prune
  • Verify
  • Sync

:heavy_check_mark: New “Last Action” sensor

A local sensor that displays the last maintenance action performed.

  • Initial state: “Waiting”
  • Instantly updated when any maintenance button is pressed
  • Fully local and independent from the coordinator
  • Stable and persistent across restarts

:heavy_check_mark: Organized by datastore

Each datastore has its own device grouping, keeping everything clean and easy to navigate.

:broom: Internal improvements and cleanup

  • Full refactor of the PBS module
  • Removal of obsolete entities
  • Cleaner, more maintainable codebase
  • Improved compatibility with Home Assistant

:motorway: Roadmap

  • Custom Lovelace card templates
  • Submission to HACS as an official repository
  • Advanced PBS maintenance sensors (progress, duration, logs)
  • Optional advanced PBS dashboard
  • Create VM/CT backups directly from PVE via Home Assistant

If you’d like to try it, share feedback, or suggest improvements, you’re more than welcome.
Every idea helps refine the integration and push it even further.

Thanks, and I hope you find it useful.

3 Likes
2

Release v1.3.0 — Proxmox Enhanced Backup & Hardware Compatibility

This update introduces the long-awaited manual backup service directly from Home Assistant, alongside critical optimizations for hardware monitoring and PBS management.

:rocket: New Feature: Manual Backups with HA Identification

You can now trigger backups for your VMs and Containers directly from Home Assistant.

  • Custom Action: Added the proxmox_sensors.create_vzdump_backup service.
  • Automatic Tagging: Backups triggered from HA are automatically labeled as ID | HA Backup to easily distinguish them from Proxmox scheduled tasks.
  • Full Deduplication: Fully compatible with PBS deduplication, maintaining storage efficiency.

:globe_with_meridians: Remote Backup Support (Tuxis, Offsite PBS, etc.)

This version has been successfully tested with remote storages. You can now trigger backups to offsite locations (like Tuxis or any remote Proxmox Backup Server) directly from Home Assistant.

  • How it works: As long as the remote storage is already configured in your Proxmox Node, simply provide its name in the storage field of the action.
  • Smart Performance: Proxmox handles the connection and deduplication. Even for remote backups, only the modified data chunks are transferred, ensuring fast and efficient offsite copies.
  • Verified: Confirmed working with remote PBS providers, including automatic tagging and Gotify notifications if configured in Proxmox.

Example YAML:

action: proxmox_sensors.create_vzdump_backup
data:
  node: your_node_name
  vmid: 100
  storage: YOUR_REMOTE_STORAGE_NAME

Home Assistant Action
Home Assistant Action1205×336 11.8 KB

New service interface in Home Assistant.

Proxmox View
Proxmox View1186×152 13.1 KB

Identified backups as seen in Proxmox Backup Server.

:hammer_and_wrench: Hardware & Compatibility Improvements

  • LM-Sensors Optimization: Improved handling of CPU temperature and fan speed readings across various Intel-based architectures and chipsets.
  • Client Refactoring: Deep cleanup of the internal API (client.py) to improve response times and request stability.
  • Log Cleanup: Removed redundant debug messages in button.py to keep the Home Assistant System Log clean.

:bar_chart: Proxmox Backup Server (PBS) Enhancements

  • Human-Readable Dates: Task and backup timestamps now use a standard format (DD/MM/YYYY HH:MM) instead of Unix timestamps.
  • Datastore Management: Improved handling of multiple datastores and maintenance states (GC, Prune, Verify).

:memo: Update Instructions

  1. Wait for HACS to notify you about the new version v1.3.0.
  2. Click on Update in the HACS dashboard.
  3. Restart Home Assistant to apply the changes.
  4. Verify that the new action appears in Developer Tools > Actions (formerly Services).
3

Looks promising! :slight_smile:

I’ll give it a try.

Have you used GitHub - dougiteixeira/proxmoxve: Proxmox VE Custom Integration Home Assistant before? Would you say, your integration includes all of its features?
I’m currently using it. Unfortunately, it seems there’s no further development going on.

4

I got it running.
As expected looks very good :slight_smile:

Any idea why the integrations icon is not loading in the UI?

image
image646×144 7.06 KB

You are querying PBS via API for task information and more.
I have realized that by using webhooks.
I am not a developer, so I cannot say which approach is “better” (more robust, consumes less resources, is easier to set up, …).
Just wanted to give a heads up, that both exists :slight_smile:

5

"Hi @chris400, thank you so much for your feedback! I’m glad to hear the integration is working well for you and that you like the UI.

Regarding your comments:

API vs Webhooks: You are right, I’m using the Proxmox/PBS API directly. I personally find this approach much more robust and reliable. While webhooks depend on the server “pushing” the data (and can sometimes fail or require extra configuration), querying the API ensures that Home Assistant always has the real-time status exactly when it needs it, without losing sync.

  • Backup Management: One of the main goals of this integration was to go beyond simple monitoring. Currently, you can already trigger individual backups for your CTs and VMs directly from Home Assistant.

  • What’s coming next: I’m finishing a major update. Soon, you will be able to trigger bulk backups (all VMs/CTs at once) with full control over the process: choosing the backup type (Snapshot, Suspend, or Stop) and compression settings** (ZSTD, LZO, GZIP), all from your HA dashboard.

The icon issue is simply because I’m still in the process of submitting the integration to the official Home Assistant “Brands” repository and preparing it for HACS. Stay tuned!

Thanks again for the support!"

1 Like