1
0
mirror of https://github.com/foxlet/macOS-Simple-KVM.git synced 2024-06-02 06:03:31 +02:00
macOS-Simple-KVM/README.md
Foxlet 5ac73d1dd4
Merge pull request #2 from jeanfrancoisgratton/patch-1
[DOCS] Skip Step 1 if BaseSystem.img is already present.
2019-05-11 17:30:23 -04:00

35 lines
1.3 KiB
Markdown

# macOS-Simple-KVM
Documentation to set up a simple macOS VM in QEMU, accelerated by KVM.
By [@FoxletFox](https://twitter.com/foxletfox), and the help of many others.
## Getting Started
You'll need a Linux system with `qemu`, `python` and the KVM extensions installed for this project. A Mac is **not** required.
## Step 1
Run `jumpstart.sh` to download installation media for macOS (internet required). The default installation uses High Sierra, but you can upgrade to Mojave later.<br>
This step is unnecessary if you already have a BaseSystem.dmg or BaseSystem.img file. If you have a BaseSystem.dmg file, you will 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 \
```
Then run `basic.sh` to start the machine and install macOS.
## 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!
Look in the `docs` folder for more information on adding passthrough hardware (for GPU graphics), set up bridged networking, and enabling sound features.