RomanNum3ral
/
quickemu
mirror of https://github.com/quickemu-project/quickemu.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Remove integrated OpenCore documentation, this feature didn't work well so was reverted.

Martin Wimpress 2026-01-26 02:07:45 +00:00
parent e95a5672d7
commit bce7deb4b5
1 changed files with 5 additions and 37 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
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.