FreeBSD 12 – bhyve VM fails to boot from UEFI loader configuration – Fix & Prevention

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

Virtual machines fail to start, impacting lab and production tenant workloads.

Environment & Reproduction

Often introduced by missing firmware files or incorrect bootrom path.

vm list
vm start appvm
bhyvectl --vm=appvm --destroy

Root Cause Analysis

UEFI firmware path, disk map, or boot order is misconfigured in VM definition.

Quick Triage

Check vm-bhyve templates, firmware packages, and tap/bridge status.

pkg info | grep -i grub2-bhyve
ls -l /usr/local/share/uefi-firmware
ifconfig bridge0

Step-by-Step Diagnosis

Run verbose start and inspect console output for firmware and disk attach errors.

vm start -f appvm
cat /zroot/vm/.config/system.conf
cat /zroot/vm/appvm/appvm.conf

Solution – Primary Fix

Set correct UEFI bootrom and validated disk mapping, then restart VM.

vm stop appvm 2>/dev/null || true
vm configure appvm
vm start appvm

Solution – Alternative Approaches

Use grub-bhyve boot path for legacy guest compatibility where UEFI is unnecessary.

grub-bhyve -m device.map -r hd0,msdos1 -M 2048 appvm

Verification & Acceptance Criteria

Guest reaches bootloader and network init reliably across restarts.

vm console appvm
vm list
vm reboot appvm

Rollback Plan

Restore previous VM config snapshot if updated boot settings fail.

cp -a /zroot/vm/appvm/appvm.conf.bak /zroot/vm/appvm/appvm.conf
vm start appvm

Prevention & Hardening

Template validated VM profiles and firmware dependency checks.

vm check appvm 2>/dev/null || true

Related Errors & Cross-Refs

Associated with bridge/TAP issues and insufficient host memory reservations.

Related tutorial: View the step-by-step tutorial for FreeBSD 12.

View all FreeBSD 12 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

FreeBSD bhyve and vm-bhyve operational documentation.