Support is provided in the Github issue tracker. Please search before posting. If there is no existing ticket, it is important that you follow the instructions in the template for a new ticket and provide all the requested information! Issues without the requested information may be rejected.

Do not ask for help in tonymacx86 (better yet, stop going to tonymacx86!). They do not permit discussion of anything except for their own "approved" installation methods--which are all pretty problematic. We tried to provide help there in the past but was banned for linking to a non-tonymac approved guide.

Known Issues

Outstanding issues are tracked and worked on in the Github issues. Some of the most common unresolved issues are documented here along with possible workarounds.

This is a hardware issue and cannot be worked around without Intel support or extensive kernel patching. If you require a USB device to not be disconnected (an external HDD for example), you can use the blue USB 3.0 Type A port on the front of the NUC. This port is connected to the CPU directly (does not go through the buggy PCH) and does not exhibit the same wakeup issue. However, it does experience a separate issue where if you have the device connected before powering on, then it will get disconnected after the first sleep. You should either plug in the device after OSX boots or suffer a single disconnect before the issue goes away.

Only boot entry is "Windows Boot Manager"

Windows sometimes modifies the NVRAM variables for force the BIOS to only show Windows as a boot option. If you have an external media with OpenCore installed, you can use it to reset the NVRAM. If you do not have access to an external media with OC installed, you need to open the case and remove the BIOS Security Jumper (see section to reset all BIOS settings.

Black screen powering up with TB DP display or TB port not working

If the Ridge controller crashes, you won't get DP output (or anything else) from the TB ports. Perform a hard reset by unplugging the power cord and plugging it back in. Then press the power button and wait until your keyboard shows up. Then press Ctrl+Alt+Del to soft-reset and you should see the display working again.

Black screen after POST when booting up or after selecting boot drive

First get into the boot picker menu, and boot into OSX. Then, you need to make sure the right startup device is selected in System Preferences -> Startup Disk. Select your OSX installation you wish to boot into and press Restart. This should fix the issue for future boots.

If this happens during an OSX upgrade, you need to manually select the updater option. After the upgrade is complete, you can configure the Startup Disk.


Before asking for help, make sure you try all the following troubleshooting advice first.

Getting into boot picker menu

Reboot and when you see the boot logo, you need to hold or repeatedly tap the Alt key (Opt key on Apple keyboards). Sometimes holding works and sometimes tapping works and sometimes neither works. This is a known issue with OpenCore and you have to keep trying.

"This copy ... is damaged, and can’t be used to install macOS."

If you get this message while installing, make sure your BIOS clock is set to the correct time and that you are connected to the internet.

If that did not solve the issue, follow the install instructions again starting from the top, but this time do not select "Patch OSX Installer" after running the package. Finally, after installation, you have to follow the upgrade instructions.


Sometimes incorrect settings and boot-args will cause issues. You need to get into boot picker and then select the NVRAM reset option.

Reset BIOS

Make sure you are on the latest BIOS version. Also try resetting BIOS to factory settings and then re-do the needed changes.

Remove Wifi Card

There are known compatibility issues with the DW1820A. If you cannot boot, remove the card and try again.

Reinstall HaC Mini

Follow the existing install directions to update/reinstall the latest version of HaC Mini. This will replace your OpenCore settings but by default a backup will be created in /EFI-backups/OC. If you made changes to the configuration and a reinstall worked, you can try adding the changes back one at a time to see what is the cause of the issue.

Disable any third party extensions

You can try booting into safe mode by holding Win+S (Cmd+S on Apple keyboards) during boot. If this does not work, get into boot picker and hold the keys while pressing the number corrosponding to your boot drive. If the issue is resolved check if any extension added in /Library/Extensions or /System/Library/Extensions are the cause by enabling them one at a time.

Enable verbose boot

Rerun the HaC Mini installer and select the following options: Verbose Boot, Debug mode, Reset boot-args. If this fails, try it without "Reset boot-args" and then reset NVRAM. If there is a panic, take a picture and include it in your support request.