Unraid VM Backup 2026.07.30.3

Unraid VM Backup 2026.07.30.3

This release strengthens repository validation, adds a guarded same-host storage option, and keeps development tooling aligned with the supported Node.js 22 runtime.

Changed

• Adds optional same-host backup repositories with an explicit safety warning.
• Validates repository access and storage separation before backups.
• Improves QEMU checkpoint cleanup and Guest Agent handling.
• Preserves the setting across service and server restarts.

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

SHA-256

14420bb062adf0be49ecded34112bcee53d6766bab08a1254ef68d1ce3df50c7  unraid.vmbackup-2026.07.30.3-x86_64-1.txz
2a3de59a7b0491737c210531ae398dfde3c9656e279f17175b661c69a9e88ffa  unraid.vmbackup.plg
0bdaa84a16c37a50dcfddc43f6678d422fa1418fe51fd413ec6a13f04500aa10  sbom.cdx.json
7b8e759e8f22f5a40c89d2b740b5040ab7d5d5db8125bfcb9a3879d49a7f62a8  SHA256SUMS.txt

Unraid VM Backup 2026.07.28.4

Changed

• Replaces the previous glossy Plugins-tab icon with the monochrome transparent icon.
• Uses the same 128 × 128 asset in Plugins, Settings, documentation, and Community Apps.
• Creates approved public releases without automatically applying the pre-release label.

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. Backup formats, repository state, restore behavior, and service configuration are unchanged.

Assets

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

SHA-256

bd8932a5ce81222c2fd929e7f24a879f603db7bd90ad6f9d9843dc247c1ae442  unraid.vmbackup-2026.07.28.4-x86_64-1.txz
f7b344600b7510ce50ce9e0fca387cf6d8c7dd4c3f48eeddf6d5f341caa2c536  unraid.vmbackup.plg
4446c35d94855077484d558f6ab46e64002ba95a0f8e5c512a9de609af6fda15  sbom.cdx.json

The public-release workflow verifies these approved hashes before creating the draft release.

Unraid VM Backup 2026.07.28.3

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