macOS Virtualization Framework Error — VM Creation and Boot Failures on Apple Silicon

Fix macOS Virtualization Framework errors when creating or running virtual machines on Apple Silicon Macs including Linux VMs, container runtimes, and dev environments. This guide covers everything you need to know about this topic, including common causes, step-by-step solutions, and answers to frequently asked questions.

Here are the key things to understand: The macOS Virtualization Framework provides native VM support on Apple Silicon without third-party hypervisors. It powers Docker Desktop, UTM, Parallels, and other VM tools on Apple Silicon Macs. VMs can run ARM64 Linux distributions and (with Parallels) ARM Windows 11. The framework requires macOS Monterey 12+ and Apple Silicon (M1/M2/M3/M4 series). Common tools using this framework: Docker Desktop, Lima, UTM, Parallels Desktop, OrbStack. Understanding these fundamentals will help you diagnose and resolve this issue more effectively.

The most common reasons this occurs include: Insufficient available RAM or disk space to allocate to the virtual machine. Trying to run x86_64 VM images on Apple Silicon without emulation (requires ARM64 images). Docker Desktop or OrbStack VM corrupted requiring recreation of the Linux VM. SIP (System Integrity Protection) or entitlement restrictions blocking VM creation. Identifying the root cause is the first step toward finding the right solution.

To resolve this, follow these recommended steps: Ensure sufficient resources: at least 4GB RAM and 20GB disk free for the VM. Use ARM64/aarch64 Linux images — not x86_64 — for native performance on Apple Silicon. For Docker Desktop: Preferences > Resources > reduce memory allocation, then restart Docker. Reset the VM: Docker Desktop > Troubleshoot > Clean/Purge data to recreate the Linux VM. Update macOS and the VM application to the latest versions for framework compatibility fixes. If these steps do not resolve the issue, consider consulting additional resources or a qualified professional.

This article is part of our Mac Error Codes collection on Error Codes Wiki. We provide comprehensive, up-to-date information to help you find solutions quickly.