Intel NUC7/NUC8 using Clover UEFI (NUC7i7Bxx,NUC8i7Bxx,etc)
The purpose of this guide is to provide a step-by-step guide to install Mojave, High Sierra, Sierra, or El Capitan on the Kaby Lake Intel NUC7 series Intel NUC mini computers. My NUC7 is the NUC7i7BNH, although I expect the guide will work on other similar models. Preliminary support for the NUC8 „Bean Canyon“ has also been added.
I installed with 8GB RAM (one stick), and an SM951/AHCI M.2 SSD. Recommend two sticks in dual-channel.
This guide does not use Unibeast nor Multibeast, but uses automated scripts to handle most of the post-installation details.
Some notes on the NUC7i7BNH
The NUC7i7BNH is similar to other NUCs. This particular NUC has a single M.2 slot for SSD and support for a 2.5″ SATA SSD or HDD.
Like the previous Skylake NUC6 the NUC comes with MSR 0xE2 locked and there is no option in the BIOS to unlock it. And as with the previous generation, this NUC has soldered WiFi/BT, with no option to replace it. For networking, Ethernet is used.
The NUC7i7BNH has an HDMI port and a Thunderbolt3 (USB-C) port. I was able to use my DP screen using a USB-C->DP cable (my monitor does not offer full resolution over HDMI).
Some notes on the NUC7i7DNKE
Recently received a „Dawson Canyon“ NUC7i7DNKE. This NUC also works by following this guide.
– KabyLake-R Core i7-8650U
– Intel UHD 620 graphics
– replaceable WiFi via M.2 2230 slot
– M.2 2280 for SSD
– dual-HDMI at back panel (one marked „Protected UHD“)
– 4x USB3 ports (2x back, 2x front)
– Ethernet (works with IntelMausiEthernet.kext)
– no analog audio (audio works via HDMI audio)
– no Thunderbolt, no USB type C
These „Dawson Canyon“ NUCs are an excellent option due to their simplicity and replaceable WiFi hardware. I replaced the Intel WiFi hardware with Broadcom BCM94352Z and it works great. The required kexts and patches are already present in the guide files.
Note: The only big difference was the USB configuration, which uses HS02->HS05 + SS02->SS05 instead of 01->04. Some other files were simplified for the Dawson Canyon NUC due to lack of analog audio.
Some notes on the NUC8i7BEH
Preliminary support for the CoffeeLake NUC8 „Bean Canyon“ has been added to the github project.
I may eventually create a separate thread for the NUC8, but for now here are the notable differences:
– add EmuVariableUefi-64.efi to drivers64UEFI
(you will experience lockups on restart, shutdown, sleep, and SysPrefs->Startup Disk without it)
– use the nuc8 variant plists (config_install_nuc8_bc.plist, config_nuc8_bc.plist)
– use the nuc8 make install script (‚make install_nuc8bc‘)
– in BIOS settings you *must* enable legacy boot (continue to boot UEFI, but enable legacy for CSM)
(you will have KP/reboot without it)
What you need
– Kaby Lake Intel NUC7 (or NUC8) series mini computer
– macOS or OS X downloaded from the Mac App Store
– 8GB USB stick (maybe 16GB, if your stick is one of those „small 8GB“ units)
– SATA SSD/HDD or M.2 AHCI (x2) or SATA SSD (keyed for B or B+M)
– RAM (my unit has 8GB RAM installed)
Note: This guide has been updated to use native Kaby Lake support as of 10.12.6. As a result, changes would be required (Skylake spoofing) if you were to attempt versions prior to 10.12.6. Support here only for 10.12.6 and later.
On my NUC7i7BNH, BIOS version 040 was installed (now updated to 045 yet).
The boot menu and BIOS setup can be accessed by mashing the F2 key during BIOS startup. After the main screen comes up choose „Advanced“. That gets you to the main BIOS setup screens.
To start, choose „Load Defaults“ (choose from the menu or press F9 in the BIOS setup).
– Boot->Boot Configuration, disable „Network Boot“
– Power->Secondary Power Settings, „Wake on LAN from S4/S5“, set to „Stay Off“
These settings are important but are already set as needed by „Load Defaults“
– Devices->Video, „IGD Minimum Memory“ set to 64mb or 128mb
– Devices->Video, „IGD Aperture Size“ set to 256mb
– Boot->Secure Boot, „Secure Boot“ is disabled
– Security->Security Features, „Execute Disable Bit“ is enabled.
– Boot->Boot Priority->Legacy Boot Priority, disable „Legacy Boot“ (it will reduce confusion).
Exception: NUC8 (read above NUC8 notes)
Preparing USB and initial Installation
This guide assumes you’re starting with nothing on your HDD/SSD (or nothing important). Make sure you backup your important files before starting.
You can also leave Windows intact, but it can get tricky. Read here for more information: http://www.tonymacx86.com/multi-booting/133940-mavericks-windows-8-same-drive-without-erasing.html
This guide for creating USB and installing using Clover UEFI works well: http://www.tonymacx86.com/el-capita…de-booting-os-x-installer-laptops-clover.html
– This guide requires Clover v4658 or later
– Definitely copy IntelMausiEthernet.kext to Clover/kexts/Other as having network support during post-install is not only helpful, but the rest of this guide depends on it.
– You do not need VoodooPS2Controller.kext as it is laptop specific.
– If you have HD615/HD620/HD630 on 10.12.5+, you may need to add Lilu.kext and IntelGraphicsFixup.kext
– Use the ‚createinstallmedia‘ approach. It works well, and there is little chance for pilot error. This method also gives you an OS X recovery partition.
– Use the config_install_nuc7.plist linked by this post instead of the laptop specific config.plist files linked by the guide. Make sure you copy it to EFI/Clover/config.plist (after installing Clover). Clover will not read a file named config_install_nuc7.plist.
For installation, config_install_nuc7.plist: https://github.com/RehabMan/Intel-NUC-DSDT-Patch/raw/master/config_install_nuc7.plist
Install Clover UEFI as described in the guide linked by the previous section (post #2). After installing Clover, and configuring it correctly (config.plist, kexts, HFSPlus.efi, etc) you should be able to boot from the HDD/SSD.
Most everything works, but there are a few things to tidy up, drivers to install, etc. For that, we need to patch ACPI, provide a proper config.plist, and install the kexts that are required.
Since you have IntelMausiEthernet.kext already injected by Clover, you should have internet access simply by using an Ethernet cable to your router. Plug it in and make sure you have internet access before continuing.
Installation of the tools and patching is easy provided the scripts and tools at the repository: https://github.com/RehabMan/Intel-NUC-DSDT-Patch
To start, the developer tools must be installed. Run Terminal, and type:
You will be prompted to install the developer tools. Since you have internet working, you can choose to have it download and install them automatically. Do that before continuing.
After the developer tools are installed, we need to make a copy of the project on github.
mkdir ~/Projects cd ~/Projects git clone https://github.com/RehabMan/Intel-NUC-DSDT-Patch nuc.git
Note: All commands for Terminal that follow will assume you have set the current working directory to ~/Projects/nuc.git (unless otherwise stated).
To change the current working directory in Terminal:
Now it is time to install some more tools and all the kexts that are required…
The download.sh script will automatically gather the latest version of all tools (patchmatic, iasl, MaciASL) and all the required kexts from bitbucket. The install_downloads.sh will automatically install them to the proper locations.
To finish the setup, we need a correctly patched ACPI.
make make install_nuc7
Or for the Dawson Canyon NUC7:
make make install_nuc7dc
The ‚make‘ causes the patched files to be compiled (with iasl), the results placed in ./build.
Finally, ‚make install_nuc7‘, mounts the EFI partition, and copies the built files where they can be loaded by Clover (to EFI/Clover/ACPI/patched).
Note: No actual patching of DSDT/SSDT is happening here. We are simply building an add-on SSDT (SSDT-NUC*.aml) which provides the necessary changes. This is because the NUC requires only minimal patching so a full patched DSDT is not needed.
Everything required for CPU/IGPU power management is already installed with the steps above.
There is no longer any need to use the ssdtPRgen.sh script.
Be aware that hibernation (suspend to disk or S4 sleep) is not well supported on hackintosh.
You should disable it:
sudo pmset -a hibernatemode 0 sudo rm /var/vm/sleepimage sudo mkdir /var/vm/sleepimage
Always check your hibernatemode after updates and disable it. System updates tend to re-enable it, although the trick above (making sleepimage a directory) tends to help.
Up to now, you’ve been using the same config.plist we were using for installation. After all the APCI files are in place (previous two steps), you’re ready to use the final config.plist from the NUC repo.
First, mount the EFI partition:
Then copy the file:
cp config_nuc7.plist /Volumes/EFI/EFI/Clover/config.plist
Or for Dawson Canyon:
cp config_nuc7_dc.plist /Volumes/EFI/EFI/Clover/config.plist
You could also copy the file using Finder.
After copying the config.plist from the repo to EFI/Clover/config.plist, you should customize the SMBIOS so you have a unique serial. You can use Clover Configurator to do this (use google to find/download it). DO NOT use Clover Configurator to edit your actual config.plist. Instead edit a „dummy“ config.plist to create the SMBIOS data and then use copy/paste with a plist editor (I use Xcode) to copy the SMBIOS section into my active config.plist. Clover Configurator is too buggy and cannot be trusted with edits to your real config.plist.
Note: The config.plist in the repo is using iMac14,2. It works. You could also use iMac17,1. The best match would be a Kaby Lake Macmini, but Apple has not yet produced one as I write this guide.
Note regarding HDMI ports: The provided config-nuc7.plist is optimized specifically for my NUC which happens to have HDMI and USB-C. Your NUC may have a different configuration, and therefore may require different framebuffer patches.
For versions of macOS or OS X prior to 10.12.6, there is no native KabyLake graphics support. For those systems, it is necessary to spoof the KabyLake graphics device as Skylake.
Note: Spoofing as Skylake is not currently 100% supported, due to missing support in WhateverGreen.kext.
You can enable that functionality by copying SSDT-SKLSPF.aml to ACPI/patched:
cp ./build/SSDT-SKLSPF.aml /Volumes/EFI/CLOVER/ACPI/patched
Or you can use ‚make install_nuc7spoof‘:
It will also work on systems with native KabyLake support, if you wish to use the Skylake drivers instead (there are reports that there is better support for 4k@60 with the Skylake drivers).
Keep in mind that after switching (either way), you must rebuild cache, then reboot at least once to enable the patches that are in config.plist.
And on systems prior to 10.12.6, you must use FakeCPUID=0x0506e3. It is in the provided plists, but disabled. Change #FakeCPUID to FakeCPUID in config.plist/KernelAndKextPatches.
Do not stop reading
Although most of the post-install tasks are done, continue to read this guide. It it has important information you should know about.
Be sure to visit „Known Problems“, especially the instructions in the „Audio:“ section. Typically, even after completing all the above tasks, audio will not work on the first reboot. You must follow the specific instructions in that section in order to get the audio kexts in cache.
In the case of a problem, don’t bother asking about with without all files requested in „Problem Reporting“.
Updates to the patch repositories
From time to time, updates may become available to the NUC repository. In the event of such updates, you may want to update your copies, and re-patch ACPI with the updates.
Since you’re using git, it is easy…
git stash # to save any local changes you might have made git pull make clean
Then you can follow the instructions for updating config.plist or using ‚make install_nuc7‘ to copy the updated SSDT.
Updates to kexts may happen at any time. You can download and install the latest versions manually (by going to their respective release sites), or by using ./download.sh, and ./install_downloads.sh.
I have tested the following features:
– UEFI booting via Clover
– DP/HDMI video/audio
– AirPlay mirroring to AppleTV
– native USB3/USB2
– native audio with AppleHDA [see below, „Known Problems“]
– native power management
– accelerated graphics for HD650 including OpenCL
– wired Ethernet
– Mac App Store working
– sleep (hibernation disabled, not tested)
– Messages/FaceTime (working on 10.10.3 even though I didn’t run through the guide: http://www.tonymacx86.com/general-help/110471-how-fix-imessage.html)
Not tested/not working
The following features have issues, or have not been tested:
– internal USB headers
In theory, this unit has two internal USB headers. I did not test them, and as a result, the custom USB configuration in SSDT-USB.dsl does not have them enabled. If you enable them and discover the port numbers, please contribute and I will add the ports to the SSDT. You can boot with -uia_ignore_rmcf to cause USBInjectAll.kext to disregard the custom configuration data in the SSDT (which enables all ports).
I don’t have a 4k monitor, so I didn’t test 4k DP video. Reports are that it works with certain monitors.
I do not have many Thunderbolt-3 devices. But I did test with a USB3 adapter to a USB3 hub. Although it worked if the device was plugged in prior to booting, hotplug was not working/not reliable. Maybe a BIOS update will help. The USB-C port did work for my DP monitor.
BT/WiFi is soldered Intel. They are not supported well on macOS/OS X.
Monitor hotplug and dual monitors remain unreliable just as with other Skylake computers. Maybe when there is a Macmini with Skylake or Kaby Lake, Apple will fix…
Find My Mac/Locking: Find My Mac does not work properly. Don’t lock your mac because it’s difficult (or impossible) to unlock again.
No Ethernet after wake: If you disable „Wake on LAN“ in BIOS, DO NOT enable „Wake for Ethernet Network access“ in SysPrefs->Energy Saver.
Audio: Currently the XML files for AppleALC have not been updated to support the internal mic on the NUC7, therefore the internal mic does not work.
Other post-install tasks
Bluetooth: If you get the Bluetooth Setup Assistant popup, go to SysPrefs->Bluetooth->Advanced, uncheck the boxes.
BIOS settings for fan control: I find with the default settings, the fan runs excessively fast. Change in Cooling->CPU Fan Header to your own preferences.
First step should be to update to the latest repository.
To do so:
git stash git pull make clean make make install_nuc7 ./download.sh ./install_downloads.sh
Also update Clover to the latest using the Clover installer. Be sure to fix EFI/Clover/kexts, so that only EFI/Clover/kexts/Other is existing. All version specific directories under EFI/Clover/kexts should be removed.
Also update config.plist at EFI/Clover/config.plist to the latest content from the repo. Be sure to retain your own SMBIOS data at config.plist/SMBIOS.
Now you can update via the App Store. Just boot the installer/updater upon restart.