Feature-complete across all three backup domains (containers, VMs, Unraid flash), plus a wave of UX, reliability and quality-of-life improvements, most of them driven by detailed Unraid forum testing.
✨ Added
- Adds the third backup domain, Unraid flash backup: BombVault now backs up and restores Docker containers, KVM/libvirt VMs and the Unraid USB flash, feature-complete across all three domains.
- Back up the whole flash (
/boot) via restic: Unraid OS, license, array config (super.dat), shares, network, SSH and plugin config, everything on the USB. Incremental + deduplicated like the other domains. - Safe restore: a flash snapshot is extracted to a recovery staging folder next to your flash repo path (
<flash repo>-restore,/mnt/user/bombvault/flash-restoreby default) that you then copy onto a fresh USB. The live, running/bootis never overwritten, so flash restore cannot leave the server unbootable. - Flash tab in the sidebar (revealed when you enable Flash under Settings > Domains): one-click "Back up flash now", a snapshot list, and per-snapshot extract-restore that shows exactly where the recovered files landed.
- Scheduled flash backups run automatically when a Flash schedule is set (per-domain everyN due-gate, scoped to flash).
- New mount: the template mounts the whole flash (
/bootto/host/boot, replacing the narrower templates-only mount it subsumes). Re-import the template (or add the mount) to enable Flash backup. - Off-site backups (rclone + SMB/NFS): a Backup Path can now be a remote restic backend,
rclone:<remote>:<bucket>/pathfor cloud (Backblaze B2, S3, Google Drive, ...). Paste your rclone config under Settings > Off-site (rclone); it is stored AES-256-GCM-encrypted (APP_KEY) and written to a0600file only for restic-to-rclone to read. - SMB/CIFS & NFS need no rclone: mount the network share on Unraid and point a Backup Path at it.
- Local and remote repos are auto-initialised on first use.
- Retention (Settings > Retention): keep-last / keep-daily / keep-weekly / keep-monthly. After each successful backup, restic prunes older snapshots to the policy (per-item, via restic's host+paths grouping). All zero = keep everything (off, the default).
- File-level restore (containers): expand a snapshot's Files, filter, and restore an individual file or folder back to its original location; recover one broken config file without restoring the whole appdata. The include path is validated to stay within the backup mount.
- Repository maintenance (Settings > Integrity & maintenance), per domain (Containers / VMs / Flash): Verify (
restic check) to confirm a repository's structure and metadata are intact, Unlock (clear a stale lock left by an interrupted run, the "repository is already locked" fix), and Prune (reclaim space from deleted backups). Friendly "no backups yet" when a repo hasn't been created; bounded by a timeout. - Pre/post-backup hooks (per container): each container can run a pre-backup and post-backup shell command (Containers > a container's Backup hooks). Commands run inside the container (
sh -c). - Pre runs while the container is still up, e.g.
mysqldump/pg_dumpinto appdata so a consistent dump is included in the backup; a failing pre-hook aborts the backup (no inconsistent snapshot). - Post runs after the container is back up (e.g. notify a webhook); its failure is logged but never fails the backup.
- Hooks are command execution by design; they run only inside the named, validated container and are gated by the same auth as every other action, with no new capability over the Docker socket BombVault already uses.
- Per-container backup-folder selection: choose exactly which mapped folders to back up, plus custom paths under the host mount.
- Backup notifications via Webhook (Generic JSON, Discord, Slack, Gotify, ntfy), Matrix, or Healthchecks.io. Policy: never / on failure / always.
- Stop other containers during a backup: name dependent containers (e.g. a database) to stop while this one is backed up and start again afterwards, over the Docker API (no scripts). They always restart, even if the backup fails.
- Plain export (tar + xml), per container: an Export button writes a browsable, tool-free copy next to your repo,
<name>.tar.gzof the backup folders plus the Unraid<name>.xmltemplate (same idea as the Appdata Backup plugin). restic stays the engine; the export is an extra, unencrypted convenience copy. - Delete individual backups: a Delete button on each snapshot (containers, VMs, flash) removes just that backup.
- Step-by-step key setup in Settings > VM Backup over SSH: one-time instructions plus a ready-to-paste authorize command (your public key inlined; it authorizes the key on the Unraid host and persists across reboots) and a link to the full setup & networking guide. No more guessing how the key works.
- Restore a VM that was deleted from Unraid. A VM with backups that is no longer defined on the host already shows under Not installed in the VM tab and can be restored there. For the case where its entry is gone too, e.g. after a fresh install or a database reset, VM backups now mirror their definition to the backup storage, and a new Discover backups button on the VM tab rebuilds the VM's entry from storage so it becomes restorable again. This brings VMs to parity with containers, which already had this.
🎨 Design
- Collapsible folder tree for file-level restore: expand/collapse like a file manager instead of one long flat list.
- Live progress bar across the full width at the bottom of each card.
- New logo in the sidebar, and the BombVault logo now shows as the favicon in your browser tab (was the default icon). In dark mode the sidebar logo gets a soft glow that lifts its dark areas off the dark sidebar while keeping all of its colours; light mode shows it plain.
- Sidebar navigation text is easier to read: a touch brighter in dark mode and darker in light mode.
- Sidebar order: "Jobs" now sits directly under "Dashboard" (above Containers).
⚡ Improved
- VM live backups are reliable and never silently shut a VM down: a live backup that hits a leftover BombVault snapshot overlay from a previously interrupted run now auto-commits that overlay and continues live; if a live snapshot genuinely cannot be taken it fails with a clear message and leaves the VM running (use the explicit "graceful" method if you want a shutdown backup). The per-VM method tooltip now spells out graceful = shutdown vs live = no downtime.
- Backups never auto-create a share: BombVault no longer creates
/mnt/user/bombvaultat first run (which Unraid turned into an undeletable share); the backup folder is created only when the first backup actually runs. - Clearer status for data-less containers: a container with no data folders reports "Config only" instead of a plain "Done".
- The dashboard shows which container/VM each run was for, and the error on failure.
- Same-repo operations are serialised, so a backup, prune or unlock can never run over each other.
- Flash backup needs the
/bootmount above; without it the app reports a clear "flash not mounted" message instead of failing obscurely. - Disabled domain tabs are hidden, not greyed out: the VMs and Flash tabs only appear in the sidebar once you enable their domain (Settings > Domains), where the VMs tab was previously always shown even when VM backup wasn't set up. A cleaner sidebar that shows only what's actually in use.
- Enabling a domain updates the sidebar instantly, no page reload: toggling VMs or Flash on/off and saving now reveals or hides the tab immediately.
- Enabling VMs requires a working SSH connection. When you turn the VMs domain on, BombVault verifies the
qemu+ssh://connection first and refuses (with a clear message) if the key isn't authorized yet, so the tab can never appear "active" without a working key. - Community Applications listing: the CA description leads with the claim and positions BombVault as the best (and only) backup tool you need for Unraid, covering all three domains (containers, VMs, flash) plus off-site repos, retention, file-level restore, integrity checks and pre/post-backup hooks.
- Transparency for the backup location. The CA description and README state that backups default to
/mnt/user/bombvault/(containers/vms/flash), created on the first backup and changeable any time under Settings > Backup paths, so nothing appears on your array unannounced. - The HTTP_ONLY template note now says: when enabled, open
http://[IP]:[PORT:3000]/(the WebUI link points to HTTPS by default). - CI boot smoke-test: CI now boots the built image and curls
/api/healthbefore pushing:latest/ the release tag, so a non-booting image can never reach the registry. - Off-site, retention and file-level restore are all configured in the app; they require no template change.
rcloneships in the image already; no new dependency.- Hardening: container exec (hook) output is read through a capped reader; JSON request bodies are size-limited (1 MiB), both from the pre-release security audit (no blockers found).
- Credits: BombVault's core idea, one-click backup and automatic re-install of Docker containers, comes from VolumeVault by @Darkdragon14 (Apache-2.0). BombVault is an independent Go + restic rewrite that extends the concept to VMs and the Unraid flash. See the README Credits section.
- Huge thanks to @manilx on the Unraid forums for the relentless testing, the clear bug reports and the sharp feature ideas; a big part of this release exists because of that feedback.
🐛 Fixed
- Run history could fail to load ("Failed to load runs"): an interrupted run left a record the history could not read; it loads again (no database reset, it was never corruption), and interrupted runs are tidied up on startup.
- "Failed to load backups" now self-heals a stale repository lock (clears it and retries).
- Containers with no appdata no longer error; they are backed up as a definition-only backup (recreated on restore).
- VM live snapshots skip cdrom / read-only disks instead of failing on them.
- Saving settings no longer wipes the auth password: the settings save rebuilt the row without the password hash (and would also have dropped the new rclone config); separately-managed secrets are now preserved across a settings save.
- VM backup failed with a 400 for VMs whose name contains a space (e.g. "Windows 11", "Home Assistant"). The name check was the strict Docker-container rule, which rejects spaces; VM names now use a libvirt-aware validator (spaces allowed; traversal / option-injection still blocked). Backup/restore of spaced-name VMs works now.
- NVRAM transfer over SSH for spaced VM names. The UEFI NVRAM path is derived from the VM name (…/
Windows 11_VARS.fd); the remote command args are now shell-quoted so the path survives the remote shell instead of splitting, so a spaced-name UEFI VM keeps its exact NVRAM on restore. - A backup no longer changes your container's run state. A container that was stopped before a backup is now backed up in place and left stopped, where previously it was started afterwards. A running container is still stopped for a consistent backup and restarted. (VMs already behaved this way.)
- Restore recreates a container in its backed-up state, instead of always starting it. A container that was stopped when backed up comes back stopped; one that was running comes back running. Hooks are skipped for a stopped container (nothing to exec into).
- VM live backup failing on the second run ("external snapshot file … already exists").
blockcommitmerges a live snapshot back into the base disk and switches the VM onto it, but doesn't delete the now-orphaned overlay file, so every successful live backup left a*.bombvault-tmpfile behind, and the next snapshot refused to start. BombVault now deletes those stray overlay files (before a backup, recovering a VM already stuck, and after each successful live backup). Live backups are repeatable again without manual cleanup. - Restore a config-only container after it's deleted. A container with no data folders is backed up as "config only" (its definition is saved, but there's no restic snapshot). Once deleted it shows under Not installed, and now has a Recreate from saved config button that rebuilds it from the stored definition (image, env, ports, volumes). An installed config-only container shows a short explanation in its Backups panel instead of a bare "No backups found".
- Privacy: the container template's VM Backup: Host default is now the placeholder
192.168.x.x(you replace it with your Unraid LAN IP) instead of a concrete address, and example IPs/ports were scrubbed from the template description and the SSH setup docs. Re-import the template (or edit the container) to pick up the new VM Backup: Host placeholder.
🌐 Translations
- 26-language UI.
- The new-feature UI strings are translated in all 26 languages. The VM-backup, Flash, off-site (rclone), retention, file-level-restore, integrity-check and pre/post-hook strings had only English + German, so the other 24 languages showed them in English. Each of the 24 locales gained the 58 missing keys, full coverage of the current feature set across every offered language.
- The German (and every non-English) UI no longer shows English button labels. The "Backing up…", "Restoring…", "Loading backups…", "Saving…" and "Done" labels on the container, VM and Settings buttons are now translated across all 26 languages; they were hardcoded English before.
Install
Search BombVault in Unraid > Apps (Community Applications). The image ghcr.io/junkerderprovinz/bombvault is public.
Image: ghcr.io/junkerderprovinz/bombvault:2.0.0 (also :2, :2.0, :latest), multi-arch (amd64 + arm64).