Skip to content

Unraid VM Backup 2026.07.28.3

Choose a tag to compare

View all tags
@MiranoVerhoef MiranoVerhoef released this 28 Jul 13:38
v2026.07.28.3
eeaf6ee
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

This is the first public release of Unraid VM Backup.

Main capabilities

  • Live and offline VM backup through libvirt/QEMU.
  • QEMU changed-block incremental backup for supported running QCOW2 disks.
  • Sparse full capture, thin-aware restore, and repository-side synthetic full backups.
  • Global and per-VM scheduling with cadence-aware GFS retention.
  • Guided restore and optional VM recreation from repository metadata.
  • Automated and manual Recovery Testing with guest-agent validation and cached screenshots.
  • SMTP notifications, repository management, backup history, structured diagnostics, and bottleneck analysis.
  • Repository reconnection after complete loss of the original server or local plugin state.

Installation

Open Unraid → Plugins → Install Plugin and enter:

https://raw.githubusercontent.com/MiranoVerhoef/Unraid-VM-Backup/main/unraid.vmbackup.plg

Then open Settings → User Utilities → Unraid VM Backup and complete First Setup.

Upgrade

Use the update control on the Unraid Plugins page.

Manual update:

wget -O /boot/config/plugins/unraid.vmbackup/unraid.vmbackup.plg \
  https://raw.githubusercontent.com/MiranoVerhoef/Unraid-VM-Backup/main/unraid.vmbackup.plg
plugin install /boot/config/plugins/unraid.vmbackup/unraid.vmbackup.plg forced && rm -f -- /boot/config/plugins/unraid.vmbackup/unraid.vmbackup.plg

The package upgrade retains local configuration and external repository data.

Recovery guidance

  • Use repository storage independent from protected VM disks.
  • Verify at least one recovery point and complete a restore or Recovery Test before relying on the backup plan.
  • A result is marked Verified only when the restored guest repeatedly responds through QEMU Guest Agent.
  • Review recreated VM storage paths, networks, firmware, removable media, and passthrough configuration before production boot.
  • After complete server loss, install the plugin on the replacement Unraid host and use Connect existing. The old boot device and old local plugin state are not required.

Known limitations

  • Changed-block incrementals require a running VM with supported QCOW2 disks and valid libvirt checkpoint metadata.
  • Raw disks, ZFS zvols/block devices, and stopped VMs use sparse full capture.
  • Guest-agent-unavailable Recovery Testing requires manual review and is not marked Verified.
  • Filesystem freeze does not guarantee application-aware consistency for every database or service.
  • This is the first public pre-release and has a limited public compatibility record.

See Known limitations for operational detail.

Assets

  • unraid.vmbackup.plg
  • unraid.vmbackup-2026.07.28.3-x86_64-1.txz
  • sbom.cdx.json
  • SHA256SUMS.txt

SHA-256

50f08f8f76ee2ef8685dbe484f31c579953c3e0e2f88813df6e1f390a10bd5e7  unraid.vmbackup-2026.07.28.3-x86_64-1.txz
476c5b169ff41ccf58b863be1112f4779dfb646d4891f6247345089c9882dfd6  unraid.vmbackup.plg
2a7fa3d8e183c6e97400c37eb7f5665b971e232f8e349dac9d3e878a1bdf4f1f  sbom.cdx.json
Assets 6
Loading