A Hackintosh project implementing the MacHyperVSupport package for Windows Hyper-V, built on top of the OpenCore bootloader and OCE-Build build manager.
Refer to the CHANGELOG or SemVer board for changes implemented per release version.
[!IMPORTANT] Beta versions of macOS may require the boot arg
-lilubetaall
to be set in theboot-args
section of your config.plist. This is needed to allow Lilu and all dependent plugins to load on macOS versions that are not yet officially supported.[!NOTE] Installations of OS X Tiger (10.4) to Snow Leopard (10.6) are not possible directly. It is recommended to first install a newer version of macOS and restore to the desired version using a disk image provided by Acidanthera.
You can also find other past InstallAssistant.dmg archives on Archive.org.
Supported versions below include macOS versions 10.4 to 15.0.
macOS Version | Status | Minimum version | Maximum version | |
---|---|---|---|---|
Sequoia | ✅ | Supported. | (None) |
(Latest) |
Sonoma | ✅ | Supported. | (None) |
(Latest) |
Ventura | ✅ | Supported. | (None) |
(Latest) |
Monterey | ✅ | Supported. | (None) |
(Latest) |
Big Sur | ✅ | Supported. | (None) |
(Latest) |
Catalina | ✅ | Supported. | (None) |
(Latest) |
Mojave | ✅ | Supported. | (None) |
(Latest) |
High Sierra | ✅ | Supported. | (None) |
(Latest) |
Sierra | ✅ | Supported. | (None) |
(Latest) |
El Capitan | ✅ | Supported. | (None) |
(Latest) |
Yosemite | ✅ | Supported. | (None) |
(Latest) |
Mavericks | ✅ | Supported. | (None) |
(Latest) |
Mountain Lion | ✅ | Supported. | (None) |
(Latest) |
Lion | ✅ | Supported. | (None) |
(Latest) |
Snow Leopard | 🚧 | Supported. | (None) |
(Retail) |
Leopard | 🚧 | Supported. | (None) |
(Retail) |
Tiger | 🚧 | Supported. | (None) |
(Retail) |
Refer to HyperV-versions.md for a complete breakdown of macOS compatibility with Windows Client, Server, and Hyper-V versions.
If you opt to use one of the pre-built releases from this repository, you can skip to 3. Setting up Hyper-V.
To clone this repository, run the below command:
git clone https://github.com/Qonfused/OSX-Hyper-V
cd OSX-Hyper-V
[!NOTE] MacHyperVSupport requires Windows Server 2012 R2 / Windows 8.1 or higher. Windows Server 2016 is currently unsupported.
As Hyper-V is a type-1 hypervisor, it requires a compatible CPU to run macOS. This means that any passed-through hardware needs to be supported or patched as you would on a bare-metal Hackintosh.
There is no GPU acceleration by default, which means any graphics-related tasks will be driven by the CPU and will be slow. To get GPU acceleration, you will need to use Discrete Device Assignment (DDA) to pass through a supported GPU for acceleration.
[!IMPORTANT] Unlike bare metal, iGPU/APUs are not visible to the VM by default and require DDA support for GPU passthrough. Additionally, most discrete GPUs, even if natively supported, may not work if passed through with DDA. Refer to the limitations section for an overview of current support in Hyper-V.
For a general overview of hardware support, refer to the CPU Support and GPU Support sections of the Dortania guide for a breakdown of hardware support by macOS version.
To setup OpenCore for your specific CPU, follow the Intel or AMD section of the Dortania Install guide for your CPU family. Ignore any USB mapping, firmware, or motherboard-specific sections as they are not relevant to Hyper-V (which provides its own virtualized hardware).
See the below sections for a breakdown of hardware support and Hyper-V-specific configuration.
[!NOTE] For Intel Tiger Lake and newer (11th Gen and newer), you can follow the Dortania install guide for Comet Lake.
You'll need to spoof your CPU as Comet Lake by using the below CPUID patch:
Kernel: Emulate: Cpuid1Data: Data | <55 06 0A 00 00 00 00 00 00 00 00 00 00 00 00 00> Cpuid1Mask: Data | <FF FF FF FF 00 00 00 00 00 00 00 00 00 00 00 00>
Add this to the config.yml file under the
Kernel -> Emulate
section or manually to the generated config.plist file underEFI/OC/config.plist
.See Cpuid1Data for other available CPUID patches for better XCPM support.
Below is a list of supported CPU generations and their initial and latest supported macOS versions:
Generation | Initial Support | Latest Support |
---|---|---|
Penryn | OS X 10.4.10 (Tiger) | macOS 10.13.6 (High Sierra) |
Clarkdale (1st Gen) | OS X 10.6.3 (Snow Leopard) | macOS 12 (Monterey) |
Sandy Bridge (2nd Gen) | OS X 10.6.7 (Snow Leopard) | macOS 12 (Monterey) |
Ivy Bridge (3rd Gen) | OS X 10.7 (Lion) | macOS 12 (Monterey) |
Haswell (4th Gen) | OS X 10.8 (Mountain Lion) | (Current) |
Skylake (6th Gen) | OS X 10.11 (El Capitan) | (Current) |
Kaby Lake (7th Gen) | macOS 10.12 (Sierra) | (Current) |
Coffee Lake (8th Gen) | macOS 10.13 (High Sierra) | (Current) |
Comet Lake (10th Gen) | macOS 10.15 (Catalina) | (Current) |
Generation | Initial Support | Latest Support |
---|---|---|
Arrandale (1st Gen) | OS X 10.6.3 (Snow Leopard) | macOS 10.13 (High Sierra) |
Sandy Bridge (2nd Gen) | OS X 10.6.7 (Snow Leopard) | macOS 12 (Monterey) |
Ivy Bridge (3rd Gen) | OS X 10.7 (Lion) | macOS 12 (Monterey) |
Haswell (4th Gen) | OS X 10.8 (Mountain Lion) | macOS 12 (Monterey) |
Broadwell (5th Gen) | OS X 10.10 (Yosemite) | macOS 12 (Monterey) |
Skylake (6th Gen) | OS X 10.11 (El Capitan) | (Current) |
Kaby Lake (7th Gen) | macOS 10.12 (Sierra) | (Current) |
Coffee Lake (8th Gen) | macOS 10.13 (High Sierra) | (Current) |
Whiskey Lake (8th Gen) | macOS 10.14.1 (Mojave) | (Current) |
Comet Lake (10th Gen) | macOS 10.15.4 (Catalina) | (Current) |
Ice Lake (10th Gen) | macOS 10.15.4 (Catalina) | (Current) |
[!IMPORTANT] AMD CPUs require the
Kernel -> Emulate -> DummyPowerManagement
option to be enabled in the config.plist as AMD does not have a native power management driver in macOS:Kernel: Emulate: DummyPowerManagement: | Boolean | true
Below is a list of supported CPU generations and their initial and latest supported macOS versions:
Generation | Initial Support | Latest Support |
---|---|---|
Bulldozer (15h) | macOS 13 (High Sierra) | macOS 12 (Monterey) |
Jaguar (16h) | macOS 13 (High Sierra) | macOS 12 (Monterey) |
Ryzen (17h) | macOS 13 (High Sierra) | (Current) |
Threadripper (19h) | macOS 13 (High Sierra) | (Current) |
In addition to AMD kernel patches (for AMD CPU families 15h, 16h, 17h and 19h), the below kernel patch is required for High Sierra and above:
Kernel:
Patch:
- Arch: String | "x86_64"
Base: String | "_cpu_syscall_init"
Comment: String | "flagers - kill invalid wrmsr | 10.13+"
Count: Integer | 3
Find: Data | "0F30"
Identifier: String | "kernel"
MaxKernel: String | "24.99.99"
MinKernel: String | "17.0.0"
Replace: Data | "9090"
You can also manually add the below plist entry to your config.plist:
This project uses OCE-Build to automatically version and build this repository's EFI.
[!IMPORTANT] To run powershell scripts, you may need to set your execution policy using:
Set-ExecutionPolicy RemoteSigned
To build this project's EFI, run one of the below commands at the root of the project:
# Build for macOS 10.8 and newer
.\scripts\build.ps1
# Build for macOS 10.7 and older
.\scripts\build.ps1 --legacy
# Build for macOS 10.4 - 10.5, 10.6 if running in 32-bit mode
.\scripts\build.ps1 --legacy --32-bit
This will create a new dist/
directory containing the EFI.vhdx virtual disk and a dist/Scripts/
directory containing various scripts for creating and configuring the virtual machine.
First check that you've enabled Hyper-V before proceeding.
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All
Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V
[!TIP] After building or downloading this project's EFI, you can run the
create-virtual-machine.ps1
script to quickly setup a new virtual-machine.For example, from a local build of this project:
# Use the latest version of macOS (cpu=2 cores, ram=8 GB, size=50 GB) .\dist\Scripts\create-virtual-machine.ps1 -name "My New Virtual Machine" # Use an older version of macOS (cpu=4 cores, ram=16 GB, size=128 GB) .\dist\Scripts\create-virtual-machine.ps1 -name "Catalina" -version 10.15 -cpu 4 -ram 16 -size 128
or from a downloaded release:
cd ~/Downloads/EFI-1.0.0-64-bit-DEBUG # Scripts are packaged with releases # Use the latest version of macOS (cpu=2 cores, ram=8 GB, size=50 GB) .\Scripts\create-virtual-machine.ps1 -name "My New Virtual Machine" # Use an older version of macOS (cpu=4 cores, ram=16 GB, size=128 GB) .\Scripts\create-virtual-machine.ps1 -name "Catalina" -version 10.15 -cpu 4 -ram 16 -size 128
Below outline the steps to manually create a new virtual machine for macOS:
Format a small (1GB) FAT32 disk initialized with GPT (GUID partition table) and mount it. This will serve as the boot partition for your macOS virtual machine and contain the OpenCore EFI folder.
Choose one of three ways of creating VHD/VHDX disks:
Action > New > Hard Disk
. C:\ProgramData\Microsoft\Windows\Virtual Hard Disks\
.Mount
.Eject
.Action > Create VHD
. Action > Attach VHD
.Detach VHD
.New-VHD
command.
# Run this command in PowerShell as Administrator
$vhdpath = "$env:USERPROFILE\Desktop\EFI.vhdx"
$vhdsize = 1GB
$vhdpart = "GPT"
$vhdfs = "FAT32"
New-VHD -Path $vhdpath -Dynamic -SizeBytes $vhdsize |
Mount-VHD -Passthru |
Initialize-Disk -PartitionStyle $vhdpart -Confirm:$false -Passthru |
New-Partition -AssignDriveLetter -UseMaximumSize |
Format-Volume -FileSystem $vhdfs -Confirm:$false -Force
Move the EFI folder (the whole folder) to the root of the VHDX disk.
EFI/
folder at the root of your EFI VHDX disk.Create or add an installer disk with either of the below methods:
.chunklist
and .dmg
files downloaded by macrecovery to your EFI VHDX disk under a new folder named com.apple.recovery.boot
. You should be left with both an EFI/
and com.apple.recovery.boot/
folder at the root of your EFI VHDX disk.qemu-img
:
qemu-img.exe convert -f raw -O vhdx InstallMacOSX.dmg InstallMacOSX.vhdx
In the Hyper-V Manager, navigate to Action > New > Virtual Machine
.
Configure the below options while going through the wizard:
Generation 2
.4096 MB
(recommended is 8192 MB
for Big Sur and newer).Once created, right click on your new virtual-machine (under the 'Virtual Machines' section of the window), and select Settings
.
Then configure the below options under the Hardware section:
Enable Secure Boot
(disable).0
and change the location value for your main virtual hard disk to a different value (e.g. 1
or 2
). This is to ensure that the EFI disk is the first disk in the boot order.Refer to the Installation Process section of the Dortania Guide. Some additional post-install sections are provided to facilitate with Hyper-V (or project) specifics.
There are some known limitations with the base configuration for Hyper-V:
[!NOTE] DDA is only available for Windows Server and Microsoft Hyper-V Server versions 2016 and newer. Windows Pro and Windows Enterprise users have no support for DDA with Hyper-V.
To enable iServices functionality, you can:
Contributions of any size to this project are always welcome!
Refer to CONTRIBUTING.md for instructions (and tips) on making contributions to this project.