What is this? Where am I?

This repository and its contents presented to you in the form of documentation and tools are to be an advanced guide and toolkit for anyone looking to create powerful OS X / macOS Virtual Machines that can handle being daily driven, used for graphical applications, and for those who want to get the maximum possible performance out of their OS X or macOS guest. The guide covers configuring a variety of QEMU Q35 machines for the entire Mac OS X / macOS Major Release Versions but its main focus will always be supporting the latest macOS release until its eventual x86_64 death, whenever that is.

Who is this for?

This is for experienced users. People in the help channels are not looking to handhold/explain/teach ideas to you! That's not really helping, especially when all of the information is here already most likely (you'll get a link as a reply to the appropriate section). For optimal results, you should already be decently familiar with the following 4 core concepts and how the subtopics relate to this project:

1. Linux
   • Understanding of the reasons why Linux is chosen over Windows as a host
   • The commandline/terminal.
   • File and folder movement through commandline/terminal
   • File and folder permissions and ownership
   • File and folder structure of linux
   • File editing from the commandline (nano, vim, or anything else)
2. QEMU
   • Virtual Machine Manager & Libvirtd in general
   • Basic understanding of manual QEMU VM creation for deep configuration
   • Kernel-Based Virtual Machines
   • How Virtualization works in general, vs Emulation
3. OpenCore Bootloader
   • Previous experience with Carnations Core Configuration Docs.
   • Why Opencore? What’s wrong with other bootloaders?
   • How Creating a Bootable USB relates to us creating an .img file to hold our own bootloader
4. The “Mac” Operating System
   • Property List Format for understanding .plist files and modifying them
   • Kext File Format
   • Understanding of File and Folder structure of OS X / macOS
   • Ability to read Kernel Panics and gather information for Helpers if need be
   • Previous General Mac OS X / macOS experience is very helpful.

If you feel as though you are not up to speed on any of these concepts, please take the time to first gain adequate knowledge as it will vastly improve your chances of having a working system you can daily drive. This guide is written completely from the ground up to teach others the proper way to create Virtual Machines as other guides do for baremetal. What this means for the user of any projects that are seen as the equivalent to "Prebuilt EFI's" on baremetal is no learning is involved. This causes the user to not understand why certain things are broken on their system and possibly may never fix those issues, potentially leaving them in the background, or even asking others for help repeatedly and never finding a solution.

← Back Next Page →