Proxmox VE VM Recovery & Stuck Boot Troubleshooting Guide

This skill provides step-by-step instructions for troubleshooting and recovering virtual machines that fail to boot or hang during the boot loader phase (such as Windows 11 guest UEFI boot loop/freeze).

1. Safety Guidelines & Rules

• ALWAYS stop the VM (qm stop <vmid>) before performing any virtual disk manipulations, mounting, or editing.
• ALWAYS back up existing disk files (especially efidisk0 and configuration files) before deleting or replacing them.
• NEVER run write operations on a VM disk while the VM is running, as this will lead to data corruption.
• DO NOT attempt to mount BitLocker encrypted partitions directly; instead, focus on repair of the unencrypted EFI bootloader partition or configuration settings.

2. Diagnosis Workflow