Disaster recovery is not merely about having backups; it is about the speed and reliability of the restoration process. When a server's physical hardware fails completely, restoring the operating system, boot partitions, and data onto a completely blank machine (Bare Metal Recovery - BMR) is traditionally fraught with driver issues, partition misalignments, and boot failures.
StateWarden’s BMR V2 architecture is built to remove this friction.
The Agent does not just restore files; it reconstructs the underlying geometry of the disk, adapts to the target environment, and performs automated EFI fixups so the restored system is bootable on the new machine.
This tutorial walks you through executing a full Bare Metal Recovery using our Kiosk Mode Recovery ISO.
1. Preparing the Recovery Media
The StateWarden Recovery ISO is a lightweight, purpose-built Alpine Linux environment designed exclusively to run the StateWarden Agent in a standalone Recovery Mode.
Step 1: Download the Kiosk ISO
- Log in to the StateWarden Dashboard.
- Download the latest Recovery ISO. The BMR dialog (see Section 2) links directly to the download page at
statewarden.com/downloads.
Step 2: Boot the Target Machine
- Flash the ISO to a USB drive using Rufus/BalenaEtcher, or attach it directly to a virtual machine hypervisor (e.g., Proxmox, VMware).
- Boot the target machine from the ISO.
The ISO will load directly into the StateWarden Recovery TUI (Text User Interface), bypassing standard OS configuration steps entirely. You will be presented with an immediate prompt for a Recovery Token.
2. Generating a BMR Token
For OpSec reasons, you do not log in to the Recovery ISO with a username and password. Instead, you authorize the recovery session from the Dashboard using a time-limited BMR Token.
- On a secure workstation, open the StateWarden Dashboard.
- Navigate to Restore Data (
/restore). - Click the BMR button to open the Bare Metal Recovery dialog.
- Select the target device you need to restore.
- Click Generate Token.
The token is displayed exactly once in the token dialog, with COPY and SAVE TO FILE options. Store it securely before closing the dialog; it cannot be retrieved afterwards.
Security Note: The token is bound to the selected device, remains valid for 24 hours, and is invalidated after first use. Generating a token requires the corresponding restore permission and is recorded in the Realm's audit trail.
3. Executing the Restoration
Return to the machine running the Recovery ISO.
Step 1: Authenticate the Agent
- Type or paste the generated BMR Token into the Recovery TUI.
- The Agent authenticates with the Control Plane (Artemis) and verifies the token before any backup data is made available.
Step 2: Select the Target Disk
- The TUI will display the disks currently attached to the blank machine (e.g.,
/dev/sda,/dev/nvme0n1). - Select the destination drive.
Warning: BMR is a destructive process. All existing data and partition tables on the selected target disk will be irreversibly overwritten.
Step 3: The "Zero-Skip" Advantage
Once confirmed, the Agent begins streaming the deduplicated chunks from the Data Plane (Driad).
During this process, StateWarden employs BMR Zero-Skip technology. The Agent analyzes the block stream; if a chunk consists entirely of zeros (unallocated space on the original drive), it utilizes BLKDISCARD/PUNCH_HOLE logic to skip the physical write operation entirely.
This skips physical writes for unallocated space, reducing restoration time and avoiding unnecessary write-wear on target SSD/NVMe drives.
4. Post-Restoration and EFI Fixups
As the data transfer completes, StateWarden performs the critical "Last Mile" steps that traditional solutions fail at:
- Partition Table Reconstruction: The Agent accurately restores the original GPT/MBR structures.
- Priority-Based EFI Fixups: The Agent analyzes the restored ESP (EFI System Partition). Instead of blindly relying on NVRAM variables (which do not exist on the new motherboard/VM), it automatically reconstructs the bootloader paths (
bcdbootequivalents, GRUB configuration) to ensure the system firmware recognizes the OS. - Completion: The TUI will display
RESTORE_SUCCESS.
5. Resuming Operations
- Remove the USB drive or detach the ISO from the VM.
- Reboot the machine.
The system boots into the state captured at the time of the backup - OS, applications, and data intact.
StateWarden: Resilience Engineered.