For the complete documentation index, see llms.txt. This page is also available as Markdown.

Veeam Integration with VergeOS

Veeam Backup & Replication protects VergeOS workloads through the VergeOS oVirt-engine package: add systems and tenants to Veeam as VergeOS Managers and deploy workers to move backup data.

Overview

Veeam Backup & Replication (VBR) 13.1 and later includes a native VergeOS integration, letting you protect workloads running on VergeOS — both in the provider (the root system) and inside individual tenants — with Veeam's backup and recovery platform.

For the network configuration the deployed components need — including extending the provider's External network into tenants — see Configuring Network Access for Veeam Backup & Replication Workers in the Knowledge Base.

How It Works

The integration is built on the VergeOS oVirt-engine package, which exposes a VergeOS system through an oVirt-compatible API. In the Veeam console, you select VergeOS under Virtualization Platforms and add the system to the inventory as a VergeOS Manager. Each tenant you want to protect is added the same way, as its own VergeOS Manager with its own engine ID.

Once a VergeOS Manager is in the inventory, Veeam deploys and manages the rest itself. The main components involved:

  • Backup server — the machine running Veeam Backup & Replication; the configuration, administration, and management core of the backup infrastructure.

  • Workers — auxiliary Linux-based VMs that Veeam deploys on the protected system to process backup workloads and move data to and from backup repositories.

  • Backup repositories — the storage locations where backups land.

Installing the oVirt-engine Package

The oVirt-engine package is an optional VergeOS package (listed as "oVirt API compatibility") delivered through the standard update system:

  1. From the top menu, navigate to System > Updates.

  2. In the Packages list, locate the ovirt-engine package. Optional packages that aren't yet installed show -- Optional -- in the Branch column.

  3. Click the cloud download icon next to ovirt-engine. Once queued, its Version column reads Not Installed→<version>.

  4. Run the update from the left menu — Download (if needed), then Install. After the install, a Reboot is required, just like a normal VergeOS update: nodes update one at a time with workloads migrated automatically, so there's no system downtime when adequate resources are available. See Updating VergeOS for the full update flow.

Requirements

  • VergeOS 26.1.7 or later — the first release whose oVirt-engine package is supported by Veeam — with the oVirt-engine package enabled

  • Veeam Backup & Replication 13.1 or later — the first release with the VergeOS integration

  • Review Veeam's Considerations and Limitations for what the integration does and doesn't support

Documentation and Resources

Support

If you encounter issues with the Veeam integration or have questions about implementation:

  • Veeam Support - Official support from Veeam

  • VergeOS Support - Technical assistance for VergeOS environments

Last updated

Was this helpful?