eeva
/
macOS-Simple-KVM
mirror of https://github.com/foxlet/macOS-Simple-KVM.git
1
0
Fork 0
Code Issues Releases Wiki Activity
53 Commits 3 Branches 0 Tags 17 MiB
Shell 51.3%
Python 48.7%
Go to file
GeckoLinux 0f99ccbdfd [DOCS] openSUSE dependencies. 
Worked for me on openSUSE Tumbleweed with recommended package automatic installation _disabled_.
 		2019-06-23 23:06:27 -04:00
docs [DOCS] Clarify nested KVM. 2019-06-23 23:05:27 -04:00
firmware [FIRMWARE] Set default vars to 1280x720. 2019-05-06 03:29:38 -04:00
tools [TOOLS] Dynamically replace machine type with highest supported QEMU version. 2019-06-23 23:05:47 -04:00
.gitignore Add tools, jumpstart, and firmware. 2019-04-22 23:20:12 -04:00
ESP.qcow2 [ESP] Update Clover to r4945, enable sound in Catalina. 2019-06-05 17:52:30 -04:00
README.md [DOCS] openSUSE dependencies. 2019-06-23 23:06:27 -04:00
basic.sh Fix warning regarding missing InstallMedia format 2019-06-19 19:40:22 -04:00
jumpstart.sh [TOOLS] Revamp FetchMacOS. 2019-06-07 02:55:09 -04:00
make.sh [TOOLS] Dynamically replace machine type with highest supported QEMU version. 2019-06-23 23:05:47 -04:00

README.md

macOS-Simple-KVM

Documentation to set up a simple macOS VM in QEMU, accelerated by KVM.

By @FoxletFox, and the help of many others. Find this useful? You can donate here!

New to macOS KVM? Check the FAQs.

Getting Started

You'll need a Linux system with qemu (3.1 or later), python3, pip and the KVM extensions installed for this project. A Mac is not required. Some examples for different distributions:

sudo apt-get install qemu-system qemu-utils python3 python3-pip  # for Ubuntu, Debian, Mint, and PopOS.
sudo pacman -S qemu python python-pip            # for Arch.
sudo xbps-install -Su qemu python3 python3-pip   # for Void Linux.
sudo zypper in python3-pip qemu-tools qemu-kvm qemu-x86 qemu-audio-pa  # for openSUSE Tumbleweed

Step 1

Run jumpstart.sh to download installation media for macOS (internet required). The default installation uses Catalina, but you can choose which version to get by adding either --high-sierra, --mojave, or --catalina. For example:

./jumpstart.sh --mojave

Note: You can skip this if you already have BaseSystem.img downloaded. If you have BaseSystem.dmg, you will need to convert it with the dmg2img tool.

Step 2

Create an empty hard disk using qemu-img, changing the name and size to preference:

qemu-img create -f qcow2 MyDisk.qcow2 64G

and add it to the end of basic.sh:

    -drive id=SystemDisk,if=none,file=MyDisk.qcow2 \
    -device ide-hd,bus=sata.4,drive=SystemDisk \

Note: If you're running on a headless system (such as on Cloud providers), you will need -nographic and -vnc :0 -k en-us for VNC support.

Then run basic.sh to start the machine and install macOS. Remember to partition in Disk Utility first!

Step 2a (Virtual Machine Manager)

If instead of QEMU, you'd like to import the setup into Virt-Manager for further configuration, just run make.sh --add.

Step 3

You're done!

To fine-tune the system and improve performance, look in the docs folder for more information on adding memory, setting up bridged networking, adding passthrough hardware (for GPUs), and enabling sound features.