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.
Find this useful? [You can donate here!](https://commerce.coinbase.com/checkout/96dc5777-0abf-437d-a9b5-a78ae2c4c227)

## Getting Started
You'll need a Linux system with `qemu`, `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.
```

## 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 set up `-vnc` to use it.

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](docs/guide-performance.md), seting up [bridged networking](docs/guide-networking.md), adding [passthrough hardware (for GPUs)](docs/guide-passthrough.md), 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 sections. 2019-05-11 23:25:09 +02:00			`By [@FoxletFox](https://twitter.com/foxletfox), and the help of many others.`
[DOCS] Disk Utility notice. 2019-06-19 22:22:59 +02:00			`Find this useful? [You can donate here!](https://commerce.coinbase.com/checkout/96dc5777-0abf-437d-a9b5-a78ae2c4c227)`
[DOCS] Update sections. 2019-05-11 23:25:09 +02:00
[DOCS] Update README. 2019-05-10 20:07:24 +02:00			`## Getting Started`
[DOCS] Clarify installation. 2019-06-07 01:53:57 +02:00			You'll need a Linux system with `qemu`, `python3`, `pip` and the KVM extensions installed for this project. A Mac is not required. Some examples for different distributions:

			```
[DOCS] Update again. 2019-06-19 22:08:54 +02:00			`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.`
[DOCS] Clarify installation. 2019-06-07 01:53:57 +02:00			```
[DOCS] Update README. 2019-04-25 22:57:52 +02:00
Initial documentation. 2019-04-23 00:08:10 +02:00			`## Step 1`
[DOCS] Clarify installation. 2019-06-07 01:53:57 +02:00			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`
			```
[DOCS] Fix formatting. 2019-05-11 23:32:56 +02:00			> 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.
Initial documentation. 2019-04-23 00:08:10 +02:00
[DOCS] Update docs. 2019-04-30 23:48:10 +02:00			`## Step 2`
[DOCS] Update README. 2019-05-10 20:07:24 +02: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 17:11:50 +02:00			```
			`qemu-img create -f qcow2 MyDisk.qcow2 64G`
			```

[DOCS] Update README. 2019-05-10 20:07:24 +02:00			and add it to the end of `basic.sh`:
[DOCS] Add instructions to create a disk. 2019-04-24 17:11:50 +02:00			```
			`-drive id=SystemDisk,if=none,file=MyDisk.qcow2 \`
			`-device ide-hd,bus=sata.4,drive=SystemDisk \`
			```
[DOCS] Update again. 2019-06-19 22:08:54 +02:00			> Note: If you're running on a headless system (such as on Cloud providers), you will need `-nographic` and set up `-vnc` to use it.
[DOCS] Add instructions to create a disk. 2019-04-24 17:11:50 +02:00
[DOCS] Update again. 2019-06-19 22:08:54 +02:00			Then run `basic.sh` to start the machine and install macOS. Remember to partition in Disk Utility first!
Initial documentation. 2019-04-23 00:08:10 +02:00
[DOCS] Update README. 2019-05-10 20:07:24 +02: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-23 00:08:10 +02:00			`## Step 3`
[DOCS] Update docs. 2019-04-30 23:48:10 +02:00
			`You're done!`

[DOCS] Include new features. 2019-06-07 22:53:10 +02:00			To fine-tune the system and improve performance, look in the `docs` folder for more information on [adding memory](docs/guide-performance.md), seting up [bridged networking](docs/guide-networking.md), adding [passthrough hardware (for GPUs)](docs/guide-passthrough.md), and enabling sound features.