Use Debug Versions

Switch to the Debug Version of OpenCore

  • If you encounter problems during booting, you should utilize the debug version of OpenCore. As explained previously in the Misc section, make sure you have activated debugging and then Select Menu -> Edit -> OpenCore DEBUG
  • Next, select Menu -> Edit -> Upgrade OpenCore and Kexts or click the Upgrade OpenCore and Kexts button.
  • Then press the Start Sync button.

Back to release version

Once everything works, switch back to the release version by taking essentially the same steps:
  • Select Menu -> Edit -> OpenCore DEBUG - This will uncheck OpenCore DEBUG in the Menu.
  • Select Menu -> Edit -> Upgrade OpenCore and Kexts or click the Upgrade OpenCore and Kexts button.
  • Press the Start Sync button.
  • Also revert relevant debug settings in Config.plist:
    • AppleDebug = NO
    • ApplePanic = NO
    • Target = 0
  • In order to remove any remaining effects of the debug session, also Reset NVRAM (then check the correct BIOS boot order and set your default boot volume in OpenCore)
Except where otherwise noted, content on this site is licensed under the Creative Commons — Attribution-NonCommercial 4.0 International — CC BY-NC 4.0 license. Attribution by link to chriswayg · GitHub.
Copy link
Edit on GitHub
On this page
Switch to the Debug Version of OpenCore