Introducing the Veeam Backup & Replication Integration for Home Assistant!

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 ​@mkevenaar for encouraging my crazy ideas like this, mainly through rubber duck debugging and alpha testing.

🔗 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, and 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)

1. Make sure Home Assistant Community Store (HACS) is installed
2. Add the repository:
   • Hit “Add Integration”
   • Use this URL: https://github.com/Cenvora/ha-veeam-br
3. Install the Veeam Backup & Replication integration
4. Restart Home Assistant

📂 Manual Install

1. Download the ha-veeam-br folder from the latest GitHub release
2. Place it under custom_components/ in your Home Assistant config
3. 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 it should still work
• This has not yet been tested with the VSA appliance, but it should still work
• This is still an early beta, so issues are likely to be encountered. When they are, please open an issue on 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!