I’m excited to share a brand-new community-driven integration that brings real-time visibility and control of your Veeam Backup & Replication environment directly into Home Assistant! As always, a big shoutout to
🔗 Project: https://github.com/Cenvora/ha-veeam-br
💡 Purpose: Surface backup jobs, repository health, license info, and more — right on your Home Assistant dashboards
🚀 What It Is
This integration connects Home Assistant to your Veeam Backup & Replication server using the REST API and exposes key metrics as sensor entities as well as some control tasks as buttons. It’s perfect for anyone who wants a consolidated view of backup status alongside other infrastructure health and home dashboards.
Key Capabilities:
-
🔌 Easy UI Setup – Configure via Home Assistant’s Integrations UI
-
📊 Backup Job Monitoring – See job status, last run, next run, job type
-
📈 Auto Refresh – Polls your Veeam server every 60 seconds
-
🎨 Dynamic Icons & Attributes – Clear visual indicators for success, failures, warnings
-
📦 Broad Coverage of Entities – Includes repository, VBR server, and license data sensors
-
🔄 Control Operations – Control various aspects of your VBR server using buttons in HA, such as:
-
Initiating repository rescans
-
Handling maintenance mode and sealed mode for SOBR extents
-
Start, stop, retry, enable, and disable backup jobs
-
🧠 Why This Matters
Many of us already use Home Assistant to centralize infrastructure visibility — power, networking, servers, storage, notifications.
This integration lets Veeam Backup & Replication become a first-class citizen in that ecosystem:
-
One place to see backup health
-
One place to act on backup issues
-
Unified notifications across home, lab, and infrastructure
For home labs, this opens up some powerful workflows.
Also, I have not yet bothered to set up proper home lab monitoring with something like Zabbix and keep throwing things into my Home Assistant instead, partly because it is a separate host/cluster.
🛠 Installation
🧩 Recommended (via HACS)
-
Make sure Home Assistant Community Store (HACS) is installed
-
Add the repository:
-
Hit “Add Integration”
-
Use this URL:
https://github.com/Cenvora/ha-veeam-br
-
-
Install the Veeam Backup & Replication integration
-
Restart Home Assistant
📂 Manual Install
-
Download the
ha-veeam-brfolder from the latest GitHub release -
Place it under
custom_components/in your Home Assistant config -
Restart Home Assistant
📌 Example: Automation Ideas
Here are a few ways you can take advantage of Home Assistant with Veeam:
# Notify on Failed Backups
automation:
- alias: "Notify on Veeam Backup Failure"
trigger:
- platform: state
entity_id: sensor.my_backup_job_status
to: "failed"
action:
- service: notify.notify
data:
title: "Veeam Backup Failed"
message: "Backup job {{ trigger.to_state.name | replace(' Status', '') }} has failed!"
Or build dashboards to show:
-
“Daily backup run summary”
-
Repository space usage alerts
-
Server and license expiry trackers
👾Known Issues
- Logos do not appear in the HA UI for the integration yet. This will be fixed once a pending PR is approved and merged in the home-assistant/brands repository
- Certain backup jobs are missing metrics as they are not fully supported by VBR REST APIs yet. For example, Proxmox backup jobs populate but “Type” and “Last Run” are both constantly “Unknown”
- This has not yet been tested with v12.1-12.3.2 but should still work
- This has not yet been tested with the VSA appliance but should still work
- This is still an early beta, so issues are likely to be encountered. When they are, please open an issue on the GitHub and include HA debug logs for us
🤝 Contribution Welcome
This is an open-source community project — contributions, issues, and pull requests are all appreciated. If you have feature ideas (more sensors, automations, etc.), jump into the GitHub repo and help evolve it!
Let me know if you want a screenshot, demo GIF, or additional examples to add to your post!
