macOS-Simple-KVM/README.md

# 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.
Initial commit 2019-04-22 07:25:21 +00:00			`# macOS-Simple-KVM`
[DOCS] Update docs. 2019-04-30 21:48:10 +00:00			`Documentation to set up a simple macOS VM in QEMU, accelerated by KVM.`
Initial documentation. 2019-04-22 22:08:10 +00:00
[DOCS] Update sections. 2019-05-11 21:25:09 +00:00			`By [@FoxletFox](https://twitter.com/foxletfox), and the help of many others.`

[DOCS] Update README. 2019-05-10 18:07:24 +00:00			`## Getting Started`
[DOCS] Update docs. 2019-04-30 21:48:10 +00: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 20:57:52 +00:00
Initial documentation. 2019-04-22 22:08:10 +00:00			`## Step 1`
Proposing to skip one step if a pre-requisite file is already present 2019-05-10 21:35:53 +00:00			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.`
Initial documentation. 2019-04-22 22:08:10 +00:00
[DOCS] Update docs. 2019-04-30 21:48:10 +00:00			`## Step 2`
[DOCS] Update README. 2019-05-10 18:07:24 +00:00			Create an empty hard disk using `qemu-img`, changing the name and size to preference:
[DOCS] Add instructions to create a disk. 2019-04-24 15:11:50 +00:00			```
			`qemu-img create -f qcow2 MyDisk.qcow2 64G`
			```

[DOCS] Update README. 2019-05-10 18:07:24 +00:00			and add it to the end of `basic.sh`:
[DOCS] Add instructions to create a disk. 2019-04-24 15:11:50 +00:00			```
			`-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-22 22:08:10 +00:00
[DOCS] Update README. 2019-05-10 18:07:24 +00:00			`## 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`.

Initial documentation. 2019-04-22 22:08:10 +00:00			`## Step 3`
[DOCS] Update docs. 2019-04-30 21:48:10 +00: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.