From 5d3c47375d44563b6059e5539bba118db9a654bc Mon Sep 17 00:00:00 2001 From: Stefan Bethke Date: Sun, 15 Nov 2026 14:06:07 +0100 Subject: [PATCH] Document the restore process for VMs --- docs/guides/restoring-vms-from-pbs.md | 38 +++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 docs/guides/restoring-vms-from-pbs.md diff --git a/docs/guides/restoring-vms-from-pbs.md b/docs/guides/restoring-vms-from-pbs.md new file mode 100644 index 00000000..1003d566 --- /dev/null +++ b/docs/guides/restoring-vms-from-pbs.md @@ -0,0 +1,38 @@ +--- +title: Create a new VM on Chaosknoten +--- + +!!! success "Goal" + + Re-create a VM from a backup. + +## VM is still defined in chaosknoten, and the backup is available in `pbs-local`. + +1. Locate the VM that you want to restore in Proxmox + +If the VM is still configured in Proxmox, locate it in the web interface and go to the Backups tab. + +1. Select `pbs-local` as the storage + +We have these storages defined for backups: +* `pbs-local`: Proxmox Backup Server running on chaosknoten +* `z9-pbs`: Proxmox Backup Server at the Club +* `local`: local file system, should be unused + +The quickest and easiest way is to restore from `pbs-local`. + +1. Select the backup that you want to restore and click Restore + +2. Decide on the way you want the VM restored + +If oyu want to be able to start using the VM immediately, choose Live Restore. This will start the VM within a minute, and any access to a disk block that has not been restored will be retrieved from the backup. The VM will run with reduced I/O capacity, but it will run immediately. + +## VM is defined, but restore must come from `z9-pbs` + +Storage `z9-pbs` is a mirror of `pbs-local`. Any backup will be encrypted with the key for `pbs-local`. + +The key configured for `z9-pbs` is different from the one for `pbs-local`, so we cannot directly restore. The solution is unclear, please see issue [Unable to restore backup on Chaosknoten from z9-pbs #188](https://git.hamburg.ccc.de/CCCHH/ansible-infra/issues/188). + +## VM is no longer defined + +Go to Datacenter > chaosknoten > Storage pbs-local, and browse the backups there. Once you have located the desired backup, follow the same steps as above. \ No newline at end of file