Skip to content
Tools to set up a quick macOS VM in QEMU, accelerated by KVM.
Shell Python Roff Makefile
Branch: master
Clone or download
Pull request Compare This branch is 28 commits ahead, 1 commit behind foxlet:master.
1
Latest commit c233ccd Nov 20, 2019

README.md

checkra1n on Linux via QEMU IOMMU Pass Through USB Controller

vmra1n provides clearer instructions

Requirements and Clone script (Ubuntu 18.04)

wget https://raw.githubusercontent.com/downthecrop/macOS-Simple-KVM/master/install.sh -v -O install.sh; chmod +x install.sh; ./install.sh

Check to see if processor virtualization is enabled

dmesg | grep -E "DMAR|IOMMU"

if no output then enable virtulization in BIOS

Get USB ID's

lspci -nn | grep -i USB

Record the first number for QEMU, the second for GRUB.

00:14.0 USB controller [0c03]: Intel Corporation Cannon Lake PCH USB 3.1 xHCI Host Controller [8086:a36d] (rev 10)

Add the second number to grub. [8086:a36d]

sudo gedit /etc/default/grub

Intel

GRUB_CMDLINE_LINUX_DEFAULT="quiet splash iommu=pt intel_iommu=on vfio-pci.ids=XXXX:XXXX"

AMD

GRUB_CMDLINE_LINUX_DEFAULT="quiet splash iommu=pt amd_iommu=on vfio-pci.ids=XXXX:XXXX"

Update GRUB

sudo update-grub

Reboot

sudo reboot

Check if vfio is enabled

dmesg | grep -i vfio

Change Configuration Files

Uncomment bottom lines from macOS.sh using the first number from the lspci -nn | grep -i USB device you passed through

edit USBmacOS.sh using the first number from the lspci -nn | grep -i USB device you passed through

Make sure you have macOS.qcow2 in the folder.

Download macOS.7z Virtual Disk Image: https://drive.google.com/open?id=1EnbopO0On4vZN7X_8zPr-k4EjCTuoQLM

Mirror1: https://mega.nz/#!dJUiUYiB!tnW7nM-oXXfyUs6EPYMLLLzXXauPqlLsB8b_gPs28Dc

Mirror2: https://mega.nz/#!wNZQQYrQ!CZ_Y8ysRIHYMcbOsh3kEAwi-m4g90mAc7vAV_q1Od8U

Note: The VM has NO password. If you need a password to run commands go to System Preferences and replace the empty password on the checkra1n account.

Extract macOS.7z to your macOS-Simple-KVM folder

Execute the Virtual Machine and Pass through PCI USB Controller

sudo ./USBmacOS.sh

Note: if you get an issue like qemu-system-x86_64: -device vfio-pci,host=00:14.0,bus=port.1,multifunction=on: vfio error: 0000:00:14.0: group 4 is not viable Please ensure all devices within the iommu_group are bound to their vfio bus driver.

You need to unbind multiple groups: https://www.reddit.com/r/jailbreak/comments/dvolsy/comment/f7ei2tp

vmra1n unbind and resolve this https://github.com/foxlet/vmra1n

Plug in your iPhone/iPad/iPod and run the tool! checkm8 Apple!

If you'd rather download the offical BaseSystem.dmg of macOS you can follow the original macOS-Simple-KVM instructions for downloading and setup.

You can’t perform that action at this time.