macOS-Simple-KVM README

The project's README from github.com/foxlet/macOS-Simple-KVM. As one markdown file: 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 on Coinbase or Paypal!.

New to macOS and KVM? Check the FAQs.

Getting Started

You'll need a Linux system with qemu (3.1 or later), python3, pip and the KVM modules enabled. 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 python-wheel  # for Arch.
sudo xbps-install -Su qemu python3 python3-pip   # for Void Linux.
sudo zypper in qemu-tools qemu-kvm qemu-x86 qemu-audio-pa python3-pip  # for openSUSE Tumbleweed
sudo dnf install qemu qemu-img python3 python3-pip # for Fedora
sudo emerge -a qemu python:3.4 pip # for Gentoo

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)

  1. If instead of QEMU, you'd like to import the setup into Virt-Manager for further configuration, just run sudo ./make.sh --add.
  2. After running the above command, add MyDisk.qcow2 as storage in the properties of the newly added entry for VM.

Step 2b (Headless Systems)

If you're using a cloud-based/headless system, you can use headless.sh to set up a quick VNC instance. Settings are defined through variables as seen in the following example. VNC will start on port 5900 by default.

HEADLESS=1 MEM=1G CPUS=2 SYSTEM_DISK=MyDisk.qcow2 ./headless.sh

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), tweaking screen resolution, and enabling sound features.

macOS-Simple-KVM (foxlet/macOS-Simple-KVM)

Searching Database…

13.9K ·GitHub
MacOS-Simple-KVM
Что это такое?Набор скриптов и инструментов для настройки виртуальной машины macOS в QEMU с ускорением через KVM, чтобы запускать macOS на компьютере с Linux.
Это готовое приложение или просто скрипты, которые я запускаю?Это набор командных скриптов (jumpstart.sh, basic.sh, make.sh, headless.sh), которые автоматизируют загрузку установочных файлов macOS, запуск и настройку виртуальной машины QEMU. Это не отдельное приложение.
Как запустить виртуальную машину macOS с помощью этого?Запустите jumpstart.sh, чтобы скачать установщик macOS (выбрав --high-sierra, --mojave или --catalina), создайте виртуальный диск командой qemu-img, затем запустите basic.sh, чтобы загрузить QEMU и установить macOS.
Нужен ли мне настоящий Mac, чтобы этим пользоваться?Нет. Нужна только система Linux с QEMU версии 3.1 или новее, python3, pip и включёнными модулями KVM.
Будет ли это работать на сервере без графического интерфейса или в облачной виртуальной машине?Не без дополнительных шагов: для систем без графического интерфейса и облачных систем нужны флаги -nographic и -vnc :0 -k en-us, а включённый скрипт headless.sh настраивает экземпляр VNC на порту 5900 для этого случая. Кроме того, перед установкой нужно разбить диск на разделы в Дисковой утилите.
Какие версии macOS можно установить?Скрипты поддерживают High Sierra, Mojave и Catalina; по умолчанию используется Catalina.
Можно ли управлять виртуальной машиной через графический интерфейс вместо команд QEMU напрямую?Да, запуск sudo ./make.sh --add импортирует настройки в Virt-Manager, где вы добавляете MyDisk.qcow2 как хранилище для записи о виртуальной машине.
Можно ли потом повысить производительность или добавить проброс GPU?Да, в папке docs описано, как добавить памяти, включить сетевой мост (bridged networking), пробросить аппаратный GPU, изменить разрешение экрана и добавить поддержку звука.
What are similar projects?OSX-KVM, macos, ProxmoxVE, Docker-OSX, vphone-aio, windows, qemu, quickemu
Which topics is it in?hackintosh, macos-virtual-machine, macos-vm, qemu, kvm, virtual-machine, script, homelab, virtualization, sysadmin, shell, networking
Creator
foxlet
Size
6.8 MB
Stars
13.9K
Updated
CommitJul 23
Age
7y
Commits · 90 Days