From bce7deb4b5fd523cb4a308d52c77b84b5edd45fc Mon Sep 17 00:00:00 2001 From: Martin Wimpress <304639+flexiondotorg@users.noreply.github.com> Date: Mon, 26 Jan 2026 02:07:45 +0000 Subject: [PATCH] Remove integrated OpenCore documentation, this feature didn't work well so was reverted. --- 03-Create-macOS-virtual-machines.md | 42 ++++------------------------- 1 file changed, 5 insertions(+), 37 deletions(-) diff --git a/03-Create-macOS-virtual-machines.md b/03-Create-macOS-virtual-machines.md index 95fd3b9..ddf9934 100644 --- a/03-Create-macOS-virtual-machines.md +++ b/03-Create-macOS-virtual-machines.md @@ -13,37 +13,6 @@ quickemu --vm macos-big-sur.conf macOS `mojave`, `catalina`, `big-sur`, `monterey`, `ventura`, `sonoma`, `sequoia` and `tahoe` are supported. -# OpenCore bootloader - -macOS VMs require [OpenCore](https://github.com/acidanthera/OpenCorePkg) as a bootloader. Quickemu handles this automatically, but the implementation differs depending on when your VM was created. - -## Integrated OpenCore (new default) - -New macOS VMs use **integrated OpenCore**, where the bootloader is embedded directly in the EFI partition of `disk.qcow2`. This approach: - -- Creates a single disk image instead of two -- Simplifies VM management and backups -- Boots directly from the main disk - -This requires `mtools` and `gptfdisk` on your system. If these are missing, `quickget` automatically falls back to the legacy method. - -## Legacy OpenCore (separate disk) - -VMs created before this change use a separate `OpenCore.qcow2` file that chainloads macOS from the main disk. This results in two disk images: - -- `OpenCore.qcow2` - bootloader disk -- `disk.qcow2` - macOS system disk - -**Existing VMs continue to work unchanged.** Quickemu automatically detects which method to use based on whether `OpenCore.qcow2` exists in the VM directory. - -## Using the legacy method for new VMs - -If you need the legacy two-disk setup for a new VM: - -1. Download `OpenCore.qcow2` from [OSX-KVM](https://github.com/kholia/OSX-KVM) -2. Place it in your VM directory before running `quickget` -3. `quickget` will detect the existing file and skip integrated OpenCore creation - - Use cursor keys and enter key to select the **macOS Base System** - From **macOS Utilities** - Click **Disk Utility** and **Continue** @@ -139,14 +108,13 @@ There are some considerations when running macOS via Quickemu. - Sonoma - Sequoia - Tahoe -- `quickget` creates macOS VMs with integrated OpenCore by default (requires `mtools` and `gptfdisk`) -- `quickemu` will automatically download the required [OpenCore](https://github.com/acidanthera/OpenCorePkg) bootloader and OVMF firmware from [OSX-KVM](https://github.com/kholia/OSX-KVM) when using the legacy method. -- Optimised by default, but no GPU acceleration is available. - - Host CPU vendor is detected and guest CPU is optimised accordingly. - - [VirtIO Block Media](https://www.kraxel.org/blog/2019/06/macos-qemu-guest/) is used for the system disk where supported. +- `quickemu` will automatically download the required [OpenCore](https://github.com/acidanthera/OpenCorePkg) bootloader and OVMF firmware from [OSX-KVM](https://github.com/kholia/OSX-KVM). + - Optimised by default, but no GPU acceleration is available. + - Host CPU vendor is detected, and the guest CPU is optimised accordingly. + - [VirtIO Block Media](https://www.kraxel.org/blog/2019/06/macos-qemu-guest/) is used for the system disk, where supported. - [VirtIO `usb-tablet`](http://philjordan.eu/osx-virt/) is used for the mouse. - VirtIO Network (`virtio-net`) is supported and enabled on macOS Big Sur and newer, but earlier releases use `vmxnet3`. - - VirtIO Memory Ballooning is supported and enabled on macOS Big Sur and newer but disabled for other support macOS releases. + - VirtIO Memory Ballooning is supported and enabled on macOS Big Sur and newer, but disabled for other supported macOS releases. - USB host and SPICE pass-through is: - UHCI (USB 2.0) on macOS Catalina and earlier. - XHCI (USB 3.0) on macOS Big Sur and newer.