QEMU on macOS 11 Big Sur

Apple releases a major version of their OS for Macs each year, but Big Sur was one of the more significant releases in the last decade. Big changes always break things, and this was no exception.

Trying to use QEMU after upgrading macOS to Big Sur or even installing an incremental update, QEMU will fail with the following error:

qemu-system-x86_64: Error: HV_ERROR
zsh: 'qemu-system-x86_64 \
    -machi…' terminated by signal SIGABRT (Abort)

This error occurs because Apple has made changes to the hypervisor entitlements. An entitlement is a right or privilege that grants an executable particular capabilities. An App stores its entitlements as key-value pairs embedded in the code signature of its binary executable. In this case, the QEMU binary isn’t signed with the entitlement to create and manage virtual machines.

So far (macOS 10.15), the entitlement needed to use the Apple hypervisor was com.apple.vm.hypervisor, but that has deprecated and replaced by com.apple.security.hypervisor.

To fix this issue, we need to add this new entitlement to the QEMU binary. In my case, I want to run x86_64 machines, qemu-system-x86_64. First, create a new entitlements.xml file with the following content:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">

Then we sign QEMU with the new entitlement:

codesign -s - --entitlements entitlements.xml --force $(where qemu-system-x86_64)

Now the qemu-system-x86_64 command should work as expected and be able to launch VMs. πŸ˜‰


#blog #development