macOS-Simple-KVM/README.md

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

Here's how to get started:

## Dependencies
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 fetch installation media for macOS (internet required). The default installation uses High Sierra.

## Step 2
Create an empty hard disk using `qemu-img`
```
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 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.
Initial commit 2019-04-22 09:25:21 +02:00			`# macOS-Simple-KVM`
[DOCS] Update docs. 2019-04-30 23:48:10 +02:00			`Documentation to set up a simple macOS VM in QEMU, accelerated by KVM.`
Initial documentation. 2019-04-23 00:08:10 +02:00
[DOCS] Update docs. 2019-04-30 23:48:10 +02:00			`Here's how to get started:`
Initial documentation. 2019-04-23 00:08:10 +02:00
[DOCS] Update README. 2019-04-25 22:57:52 +02:00			`## Dependencies`
[DOCS] Update docs. 2019-04-30 23:48:10 +02:00			You'll need a Linux system with `qemu`, `python` and the KVM extensions installed for this project. A Mac is not required.
[DOCS] Update README. 2019-04-25 22:57:52 +02:00
Initial documentation. 2019-04-23 00:08:10 +02:00			`## Step 1`
[DOCS] Update docs. 2019-04-30 23:48:10 +02:00			Run `jumpstart.sh` to fetch installation media for macOS (internet required). The default installation uses High Sierra.
Initial documentation. 2019-04-23 00:08:10 +02:00
[DOCS] Update docs. 2019-04-30 23:48:10 +02:00			`## Step 2`
[DOCS] Add instructions to create a disk. 2019-04-24 17:11:50 +02:00			Create an empty hard disk using `qemu-img`
			```
			`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.
Initial documentation. 2019-04-23 00:08:10 +02:00
			`## Step 3`
[DOCS] Update docs. 2019-04-30 23:48:10 +02:00
			`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.