From db24acf23c7e288e237eed33548c0070f532b42b Mon Sep 17 00:00:00 2001 From: Martin Wimpress <304639+flexiondotorg@users.noreply.github.com> Date: Sun, 21 Apr 2024 12:03:28 +0100 Subject: [PATCH] =?UTF-8?q?Updated=2003=20=E2=80=90=20Create=20macOS=20gue?= =?UTF-8?q?sts=20(markdown)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 03-‐-Create-macOS-guests.md | 47 +++++++++++-------------------------- 1 file changed, 14 insertions(+), 33 deletions(-) diff --git a/03-‐-Create-macOS-guests.md b/03-‐-Create-macOS-guests.md index 41614bf..decce57 100644 --- a/03-‐-Create-macOS-guests.md +++ b/03-‐-Create-macOS-guests.md @@ -1,6 +1,4 @@ -# Automatically create macOS Guests 🍏 - -`quickget` automatically downloads a macOS recovery image and creates a virtual machine configuration. +`quickget` automatically downloads a macOS recovery image and creates a virtual machine configuration. **Installing macOS in a VM can be a bit finicky, if you encounter problems, [check the Discussions](https://github.com/quickemu-project/quickemu/discussions) for solutions or ask for help there** 🛟 ``` shell quickget macos catalina @@ -91,7 +89,7 @@ macos_release="catalina" - And VirtIO Block Media (disks) are supported/stable in Catalina and newer. -### macOS compatibility +# macOS compatibility There are some considerations when running macOS via Quickemu. @@ -103,45 +101,28 @@ There are some considerations when running macOS via Quickemu. - Monterey - Ventura - Sonoma -- `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). +- `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 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 previous releases use `vmxnet3`. - - VirtIO Memory Ballooning is supported and enabled on macOS Big - Sur and newer but disabled for other support macOS releases. + - 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. + - [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. - 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. - Display resolution can only be changed via macOS System Preferences. -- **Full Duplex audio requires [VoodooHDA - OC](https://github.com/chris1111/VoodooHDA-OC) or pass-through a USB - audio-device to the macOS guest VM**. -- NOTE! [Gatekeeper](https://disable-gatekeeper.github.io/) and - [System Integrity Protection - (SIP)](https://developer.apple.com/documentation/security/disabling_and_enabling_system_integrity_protection) - need to be disabled to install VoodooHDA OC -- File sharing between guest and host is available via - [virtio-9p](https://wiki.qemu.org/Documentation/9psetup) and [SPICE +- **Full Duplex audio requires [VoodooHDA OC](https://github.com/chris1111/VoodooHDA-OC) or pass-through a USB audio-device to the macOS guest VM**. + - NOTE! [Gatekeeper](https://disable-gatekeeper.github.io/) and [System Integrity Protection (SIP)](https://developer.apple.com/documentation/security/disabling_and_enabling_system_integrity_protection) need to be disabled to install VoodooHDA OC +- File sharing between guest and host is available via [virtio-9p](https://wiki.qemu.org/Documentation/9psetup) and [SPICE webdavd](https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24). - Copy/paste via SPICE agent is **not available on macOS**. -### macOS App Store +## macOS App Store -If you see *"Your device or computer could not be verified"* when you -try to login to the App Store, make sure that your wired ethernet device -is `en0`. Use `ifconfig` in a terminal to verify this. +If you see *"Your device or computer could not be verified"* when you try to login to the App Store, make sure that your wired ethernet device is `en0`. Use `ifconfig` in a terminal to verify this. -If the wired ethernet device is not `en0`, then then go to *System -Preferences* -\> *Network*, delete all the network devices and apply the +If the wired ethernet device is not `en0`, then then go to *System Preferences* -\> *Network*, delete all the network devices and apply the changes. Next, open a terminal and run the following: ``` shell