OSX-KVM

You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

4.3 KiB

Raw Permalink Blame History

Notes

Enoch bootloader is not used for macOS High Sierra. Clover is used instead.

Host System Details

Known to work on:

Fedora 26/27 running on Ryzen 7 1800X CPU.
Fedora 27 running on i7-6600U CPU.
Fedora 27 running on i7-5820K CPU.
Ubuntu 17.04 running on i5-6500 CPU.
Gentoo (October-2017) running on AMD FX-8320 CPU with AMD RX 470 GPU passthrough.

Tested with QEMU >= 2.10 (with an out-of-tree patch) and Linux 4.10.x / 4.12.x. A CPU with SSE4.1 support is required for macOS High Sierra. Intel VT-x / AMD SVM is required.

Installation Preparation

Preparation steps on your current macOS installation

Download macOS High Sierra installer from Apple App Store.

If you are getting a partial installer from the Apple App Store, follow the instructions here to get the full (5GB) version instead.
Clone this repository. Files included in this repository are needed for ISO creation.
```
git clone https://github.com/kholia/OSX-KVM.git
```
Run the ISO creation script create_iso_highsierra.sh included in this folder. Run it with sudo.
Copy the generated ISO image from your Mac's Desktop to your QEMU/KVM machine.

Preparation steps on your QEMU system

Clone this repository again on your QEMU system. Files from this repository are used in the following steps.

Install required software packages.

sudo apt-get install qemu uml-utilities libguestfs-tools

Build and use QEMU from source. See http://wiki.qemu-project.org/Hosts/Linux for help.

# First edit /etc/apt/sources.list to add/uncomment deb-src lines

sudo apt-get update

sudo apt-get build-dep qemu

git clone https://github.com/kholia/qemu.git

cd qemu

git checkout macOS

git submodule init

git submodule update --recursive

./configure --prefix=/home/$(whoami)/QEMU --target-list=x86_64-softmmu --audio-drv-list=pa

$ make clean; make -j8; make install

This step is not optional and is required. QEMU 2.10.1 shipped with Fedora 27 works fine too.

See networking notes to setup guest networking.
Create a virtual HDD image where macOS will be installed.
```
qemu-img create -f qcow2 mac_hdd.img 128G
```
Create bootable Clover disk.
```
sudo ./clover-image.sh --iso Clover-v2.4k-4380-X64.iso --cfg clover/config.plist.stripped.qemu --img Clover.qcow2
```
Instead of building your own bootable Clover disk, you may use the included Clover.qcow2 disk image.

Installation

To install macOS High Sierra, use the included boot-macOS-HS.sh script.

Note: Ensure that the OVMF resolution is set to 1024x768. This can be done via the OVMF menu, which you can reach with a press of the ESC button during the OVMF boot logo. In the OVMF menu settings, set Device Manager -> OVMF Platform Configuration -> Change Preferred Resolution for Next Boot to 1024x768 . Commit changes and exit the OVMF menu. Relaunch the boot-macOS-HS.sh script.

Installer Steps

After booting, the initial language selection should show up.
After selecting the language, fire-up the Terminal program and prepare the hard drive for installation.
```
diskutil list
diskutil eraseDisk JHFS+ macOS disk0  # adapt this according to your system
```
High Sierra's Disk Utility does not recognize unformatted disks, unless you click View > Show All Devices, quit Disk Utility, then relaunch it.

Thanks to https://tinyapps.org/blog/mac/ and xenadu02 for this tip.
When done, quit Terminal.
Now, you can continue with the installation as usual.
When finished, the VM will reboot automatically and the first time setup continues as usual.

Post-Installation Recommendations

Install Clover to the main hard drive where macOS High Sierra was installed in previous steps. See UEFI notes for details.
For debugging and general tips, see the main README.md file and notes.md file.
For USB and GPU passthrough notes, see UEFI notes file.

4.3 KiB Raw Permalink Blame History