General Troubleshooting
Last edited: Febuary 11, 2020
This section is for those having issues booting either OpenCore, macOS or having issues inside macOS. This page is devided up into a couple sections:
​OpenCore booting issues​
This is anytime before or during the loading of the macOS kernel
​macOS booting issues​
Anytime between the kernel loading and installing macOS
​macOS post-install issues​
Anytime after macOS is installed
​Other issues​
This includes troubleshooting tools used for making your USB, fixing cosmetics in OpenCore, etc
While still a work in progress, laptop users wanting to convert an existing Clover install can see the Clover to OpenCore conversion for more info
And if your issue is not covered, please read the offical OpenCore documentation: Configuration.pdf​
Stuck on
no vault provided!Stuck on EndRandomSeed
Can't see macOS partitions
Black screen after picker
Stuck on
OC: OcAppleGenericInput... - SuccessStuck on
OCB: OcScanForBootEntries failure - Not FoundStuck on
OCABC: Memory pool allocation failure - Not FoundStuck on
OCS: No schema for DSDT, KernelAndKextPatch, RtVariable, SMBIOS, SystemParameters...Stuck on
OC: Driver XXX.efi at 0 cannot be foundStuck on
Buffer Too SmallStuck on
Plist only kext has CFBundleExecutable keyReceiving
Failed to parse real field of type 1Stuck after selection macOS partition on OpenCore
Can't select anything in the picker
Stuck on
This version of Mac OS X is not supported: Reason Mac...Couldn't allocate runtime areaerrors?SSDTs not being added
Booting OpenCore reboots to BIOS
Turn the following off in your config.plist under Misc -> Security:
RequireSignatureRequireVault
If you have already executed the sign.command you will need to restore the Opencore.efi file as the 256 byte RSA-2048 signature has been shoved in. Can grab a new copy of Opencore.efi here: OpenCorePkg​
Couple problems:
ProvideConsoleGopis likely missing as this is needed for transitioning to the next screen, this was originally part of AptioMemoryFix but is now within OpenCore as this quirk. Can be found under UEFI -> QuirksMissing kernel patches(only applies for AMD CPUs, make sure they're Opencore patches and not Clover. Clover uses
MatchOSwhile OpenCore hasMinKernelandMaxkernel)IgnoreInvalidFlexRatiomissing, this is needed for Broadwell and older. Not for AMD and Skylake or newer
Another possible problem is that some users either forget or cannot disable CFG-Lock in the BIOS(specifically relating to a locked 0xE2 MSR bit for power management, obviously much safer to turn off CFG-Lock). Do note this is for Intel users only, not AMD. When this happens, there's a couple of possible fixes:
Enable
AppleXcpmCfgLockandAppleCpuPmCfgLock, this disablesPKG_CST_CNFIG_CONTROLwithin the XNU and AppleIntelCPUPowerManagment respectively. Not recommended long term solution as this can cause instability.
Another other possible problem is IRQ conflicts, Clover has plenty of different fixes that it can apply without you directly setting them. This makes it much more difficult when converting from Clover to OpenCore though luckily CorpNewt's also got a fix: SSDTTime's FixHPET option
Main things to check:
ScanPolicy set to
0to show all drivesHave the proper firmware drivers such as ApfsDriverLoader and HFSPlus(or VBoxHfs)
Enable
AvoidHighAllocif you're running a network recovery install
This is due to missing ConsoleGOP, enable it under your config:
UEFI -> Quirks -> ProvideConsoleGOP
If this doesn't help, grab the debug versions of OpenCore.efi and BOOTx64.efi and replace them in your EFI. This will show much more info on where your hack is actually getting stuck.
So this isn't actually an error, instead OpenCore isn't showing you all the debug info. This is right before/while the kernel is being loaded so things we need to check for:
Intel:
CFG-Lock disabled in the BIOS or
AppleCpuPmCfgLockandAppleCpuPmCfgLockenabled under Kernel -> Quirks
AMD:
Verify you have added the correct kernel patches to your config(remember, OpenCore patches use
MinKernelandMaxKernelwhile Clover hasMatchOS)​Ryzen/Threadripper(17h)​
If this doesn't help, grab the debug versions of OpenCore.efi and BOOTx64.efi and replace them in your EFI. This will show much more info on where your hack is actually getting stuck.
This is due to OpenCore being unable to find any drives with the current ScanPolicy, setting to 0 will allow all boot options to be shown
Misc -> Security -> ScanPolicy -> 0
This is due to either incorrect BIOS settings and/or incorrect Booter values. Make sure config.plist -> Booter -> Quirks is correct and verify your BIOS settings:
Above4GDecoding is Enabled
CSM is Disabled(Enabling Windows8.1/10 WHQL Mode can do the same on some boards)
This is due to either using a Clover config with OpenCore or using a configurator such as Mackie's Clover and OpenCore configurator. You'll need to start over and make a new config or figure out all the garbage you need to remove from your config. This is why we don't support configurators, they are known for these issues
Verify that your EFI/OC/Drivers matches up with your config.plist -> UEFi -> Drivers
UEFI -> Quirks -> AvoidHighAlloc -> EnableEnable Above4GDecoding in the BIOS
Missing or incorrect Executable path
A value is set as
realwhen it's not supposed to be, generally being that Xcode convertedHaltLevelby accident:<key>HaltLevel</key><real>2147483648</real>To fix, swap
realforinteger:<key>HaltLevel</key><integer>2147483648</integer>
CFG-Lock not off(Intel Users only), couple solutions:
​Patch your MSR E2(Recommended solution)
Enable
AppleXcpmCfgLockandAppleCpuPmCfgLock, this disablesPKG_CST_CNFIG_CONTROLwithin the XNU and AppleIntelCPUPowerManagment repectively. Not recommeneded long term solution as this can cause instability.
AMD kernel patches aren't working(AMD Users only):
Either outdated or missing kernel patches
Incompatible keyboard driver:
Disable
PollAppleHotKeysand enableKeySupport, then remove AppleUsbKbDxe from your config.plist -> UEFI -> DriversIf the above doesn't work, reverse: disable
KeySupport, then add AppleUsbKbDxe to your config.plist -> UEFI -> Drivers
Incompatible keyboard driver:
Disable
PollAppleHotKeysand enableKeySupport, then remove AppleUsbKbDxe from your config.plist -> UEFI -> DriversIf the above doesn't work, reverse: disable
KeySupport, then add AppleUsbKbDxe to your config.plist -> UEFI -> Drivers
This error happens when SMBIOS is one no longer supported by that version of macOS, make sure values are set in PlatformInfo->Generic with Automatic enabled. Reminder of supported SMBIOS:
iMac13,x+
iMacPro1,1
MacPro6,1+
MacBook8,1+
MacBookAir5,x+
MacBookPro9,x+
See Fixing KALSR slide values​
So with Opencore, there's some extra security checks added around ACPI files, specifically that table length header must equal to the file size. This is actually the fault of iASL when you compiled the file. Example of how to find it:
* Original Table Header:* Signature "SSDT"* Length 0x0000015D (349)* Revision 0x02* Checksum 0xCF* OEM ID "ACDT"* OEM Table ID "SsdtEC"* OEM Revision 0x00001000 (4096)* Compiler ID "INTL"* Compiler Version 0x20190509 (538510601)
The Length and checksum value is what we care about, so if our SSDT is actually 347 bytes then we want to change Length to 0x0000015B (347)(the 015B is in HEX)
Best way to actually fix this is to grab a newer copy of iASL or Acidanthera's copy of maciASL and remaking the SSDT
Incorrect EFI folder structure, make sure all of your OC files are within an EFI folder located on your ESP(EFI system partition)
Stuck on
RTC...,PCI ConfigurationBegins,Previous Shutdown...,HPET,HID: Legacy..."Waiting for Root Device" or Prohibited Sign error
macOS installer in Russian
Stuck on or near
IOConsoleUsers: gIOScreenLock...Black screen after
IOConsoleUsers: gIOScreenLock...on Navi300 series Intel stalling on
apfs_module_start...Stalling on
apfs_module_start...,Waiting for Root device,Waiting on...IOResources...,previous shutdown cause...in CatalinaKernel Panic
Cannot perform kext summaryKernel Panic
AppleIntelMCEReporterKernel Panic
AppleIntelCPUPowerManagementStop Sign with corrupted text(Still waiting for Root Device)
Frozen in the macOS installer after 30 seconds
15h/16h CPU reboot after Data & Privacy screen
Well this general area is where a lot of PCI devices are configured, and is where most boot ing issues with AMD hacks happen. The main places to check:
Missing EC patch:
Make sure you have your EC SSDT both in EFI/OC/ACPI and ACPI -> Add, double check it's enabled.
If you don't have one, grab it here: SSDT-EC-USBX-AMD.aml​
IRQ conflict:
Make sure either Above4GDecoding is enabled in the BIOS, if no option availible then add
npci=0x2000to boot args. Do not have both the Above4G setting enabled and npci in boot args, they will conflictOther BIOS settings that are important: CSM disabled, Windows 8.1/10 UEFI Mode enabled
Generally seen as a USB error, couple ways to fix:
if you're hitting the 15 port limit, you can temporarily get around this with
XhciPortLimitbut for long term use, we recommend making a USBmap. CorpNewt also has a guide for this: USBmap Guide​Another issue can be that certain firmware won't pass USB ownership to macOS, to fix this we can enable
ReleaseUsbOwnership. Clover equivalent isFixOwnership
Default sample config is in russian because slavs rule the Hackintosh world, check your prev-lang:kbd value under NVRAM -> Add -> 7C436110-AB2A-4BBB-A880-FE41995C9F82. Set to 656e2d55533a30 for American: en-US:0 and a full list can be found in AppleKeyboardLayouts.txt​
You may also need to reset NVRAM in the boot picker as well
Still didn't work? Well time for the big guns. We'll force remove that exact property and let OpenCore rebuild it:
NVRAM -> Block -> 7C436110-AB2A-4BBB-A880-FE41995C9F82 -> Item 0 then set it Type String and Value prev-lang:kbd
This is right before the GPU is properly initialized, verify the following:
GPU is UEFI capable(GTX 7XX/2013+)
CSM is off in the BIOS
Forcing PCIe 3.0 link speed
Add
agdpmod=pikerato boot argsswitch between different display outputs
Commonly due to systems running AWAC clocks, pleas see the Getting started with ACPI section
Verify your EC SSDT is enabled and correct for your system. See the What's new in macOS Catalina post for more info
Generally seen as an issue surrounding the prelinked kernel, specifically that macOS is having a hard time interpreting the ones we injected. Verify that your kexts are in the correct order(master then plugins, Lilu always being first) and that kexts with executables have them and plist only kexts don't.
With macOS catalina, dual socket support is broken, and a fun fact about AMD firmware is that some boards will actually report multiple socketed CPUs. To fix this, add AppleMCEReporterDisabler to both
This is likely due to faultly or outright missing NullCPUPowerManagement, the one hosted on AMD OSX's Vanilla Guide is corrupted. Go yell at Shannee to fix it. To fix the issue, remove NullCPUPowerManagement from Kernel -> Add and EFI/OC/Kexts then enable DummyPowerManagement under Kernel -> Quirks
With OS X 10.11 El Capitan, Apple imposed a 15 USB port limit. To get around this we actually create a USB map to include ports we want and kick out extras we don't care about. For install, set Kernel -> Quirks -> XhciPortLimit -> Enabled but for post install we recommend making a map as the port limit patch isn't guaranteed to work with future versions of macOS.
For 15h and 16h AMD CPUs, you may need to add the following:
​XLNCUSBFix.kext​
If XLNCUSBFix still doesn't work, then try the following:
​AMD StopSign-fixv5​
This is likely due to faultly or outright missing NullCPUPowerManagement, the one hosted on AMD OSX's Vanilla Guide is corrupted. Go yell at Shannee to fix it. To fix the issue, remove NullCPUPowerManagement from Kernel -> Add and EFI/OC/Kexts then enable DummyPowerManagement under Kernel -> Quirks
Follow directions here after UPDATE 2: Fix Data and Privacy reboot​
This is a common example of screwed up TSC, for most system add VoodooTSCSync​
For Skylake-X, many firmwares including Asus and EVGA won't write to all cores. So we'll need to reset the TSC on cold boot and wake with TSCAdjustReset. Compiled version can be found here: TSCAdjustReset.kext. Note that you must open up the kext(ShowPackageContents in finder, Contents -> Info.plist) and change the Info.plist -> IOKitPersonalities -> IOPropertyMatch -> IOCPUNumber to the number of CPU threads you have starting from 0(i9 7980xe 18 core would be 35 as it has 36 threads total)
​Broken iMessage and Siri​
No on-board audio
BIOS reset or sent into Safemode after reboot/shutdown?
macOS GPU acceleration missing on AMD X570
DRM Broken
"Memory Modules Misconfigured" on MacPro7,1
Apps crashing on AMD
No temperature/fan sensor output
En0 device not setup as
Built-in, couple ways to fix:Find PCI path for your NIC with gfxutil(ie:
ethernet, GBE1, ). Then via DeviceProperties in your config.plist, apply the property ofbuilt-inwith the value of01and typeData. Hackintool can also grab the PCIRooth path if you're having issues with gfxutil. Recommended method​NullEthernet.kext + SSDT-RMNE. Only recommended when first solution doesn't work
If these fixes do not work, see the Fixing iServices page for more in-depth guide.
Verify that your PCIRoot is correct for your audio controller, this can be verified with gfxutil though keep in mind that not all audio controllers are named HDEF. Verfy what yours is via IORegistryExplorer(Common 2 are HDEF and HDAS)
path/to/gfxutil -f HDEF
Then add this PCIRoot with the child layout-id to your config.plist under DeviceProperties -> Add:
Then find out your layout-id for your specific codec: AppleALC's supported codec​
For this example, we'll find the layout-id for ALC1150. Looking at the supported list we're given the following:
0x100001, layout 1, 2, 3, 5, 7, 11
0x100001 refers to the codc revision, you can ignore this. For us what we care about is layout 1, 2, 3, 5, 7, 11, we want to test each one individually until you find a layout that works best for you. Remember that the DeviceProperty is in HEX, converting 5 to HEX becomes 05000000 and converting 11 to HEX becomes 0B000000 .
Alternative is using alcid=xxx in your boot-args and replace xxx with your layout-id
Issue with AppleRTC, quite a simple fix:
Under
Kernel -> patch:
Key | Type | Value |
Comment | String | Disable RTC checksum update on poweroff |
Enabled | String | YES |
Count | Number | 1 |
Base | String | __ZN8AppleRTC14updateChecksumEv |
Identifier | String | com.apple.driver.AppleRTC |
Limit | Number | 0 |
Find | Data | ​ |
Replace | Data | c3 |
Verify the following:
GPU is UEFI capable(GTX 7XX/2013+)
CSM is off in the BIOS
Forcing PCIe 3.0 link speed
With Haswell and newer iGPUs, DRM is outright broken on them with macOS Catalina. This includes iTunes Movies, Apple TV+, Amazon Prime and Netflix, the only fix is getting a supported dGPU preferably Polaris or newer that supports HEVC.
More other GPUs, try different shiki boot args:
Add MacProMemoryNotificationDisabler kext to EFI/OC/Kexts and Kernel -> Add. Note that this kext has an odd quirk here it requires WhateverGreen to function correctly.
Easy fix, buy Intel
So with AMD, whenever Apple calls CPU specific functions the app witll either not work or outright crash. Here are some apps and their "fixes":
Adobe Products don't always work and there is no fix for lightroom at the moment
Some fixes can be found here: Adobe Fixes​
Do note these fixes just disable functionality, they're not real fixes
Virtual Machine running off of AppleHV's framework will not work(ie: Parallels 15, Vmware)
VirtualBox works fine as it doesn't use AppleHV
VMware 10 and older can work as well
Docker broken
Docker toolbox is the only solution as it's based off of VirtualBox, many feautures are unavailble with this version
Xcode AppleWatch simulator is broken in Catalina
Mojave works fine
Blender 2.8.0+ won't work
2.7.9 is last good version
15/16h CPU webpages crashing
Follow directions here after UPDATE 5: Fix webpages​
Can't run
acpidump.efiFixing SSDTTime:
Could not locate or download iasl!Fix Python:
Python is not installed or not found on PATHWindows Startup Disk can't see APFS drives
Incorrect resolution with OpenCore
No temperature/fan sensor output
Can't find Windows/Bootcamp drive in picker
Call upon OpenCore shell:
shell> fs0: //replace with proper drive​fs0:\> dir //to verify this is the right directory​Directory of fs0:\​01/01/01 3:30p EFI​fs0:\> cd EFI\OC\Tools //note that its with forward slashes​fs0:\EFI\OC\Tools> acpidump.efi -b -n DSDT -z
This is usually due to an outdated version of Python, try either updating Python or add iasl to the scripts folder for SSDTTime:
​iasl macOS version​
​iasl Windows version​
​iasl Linux version​
Easy fix, download and install the latest python:
​macOS link​
​Windows link​
​Linux link​
Make sure Add Python to PATH
Outdated Bootcamp drivers(generally ver 6.0 will come with brigadier, BootCamp Utility in macOS provides newer version like ver 6.1). CorpNewt has also forked brigadier fixing these issues as well: CorpNewt's brigadier​
Follow Hiding Verbose for correct setup, set
UIScaleto02for HiDPIUsers also have noticed that setting
ConsoleModeto Max will sometimes fail, leaving it empty can help
So couple things:
iStat Menus doesn't yet support MacPro7,1 readouts
VirtualSMC's sensors do not support AMD
For iStat, you'll have to wait for an update. For AMD users, you can use: FakeSMC3_with_plugins​
Note for AMD:
FileVault support requires more work with FakeSMC
Make sure no other SMC kexts are present, specifically those from VirtualSMC​
So with OpenCore, we have to note that legacy Windows installs are not supported, only UEFI. Most installs now are UEFI based but those made by BootCamp Assistant are legacy based, so you'll have to find other means to make an installer(Google's your friend). This also means MasterBootRecord/Hybrid partitions are also broken so you'll need to format the drive you want to install onto with DiskUtility. See the Multiboot Guide on best practices
Now to get onto troubleshooting:
Make sure
Misc -> Secuirty -> ScanPolicyis set to0to show all drivesEnable
Misc -> Boot -> Hideselfis enabled when Windows bootloader is loacated on the same driveEnable
Platforminfo -> Generic -> AdviseWindows -> Trueif the EFI partition isn't the first on the partition table
