✍️
OpenCore Visual Beginners Guide
  • 📗Step-by-Step
    • Intro & Hardware
    • Create EFI & Config - OCAuxiliaryTools
    • Create macOS Installer - OCLP
    • Install & Postinstall
      • USB Port Mapping
    • Use Debug Versions
    • Upgrade OpenCore
    • Hackintosh Checklist
    • Tools and Boot Keys
  • 📙Alternatives
    • Create macOS Installer - TINU
    • USB Mapping on Windows
  • 📘Advanced Topics
    • Open Core Legacy Patcher (OCLP)
      • Broadcom Wifi on macOS Sequoia
    • Using Alder Lake (or Raptor Lake)
    • BIOS Settings Explained
    • OpenCore UEFI Shell
      • acpiview - command
    • Dual-Boot Options
      • Dual-Boot on Single Disk
      • Create rEFInd BOOTer
    • Common Boot Args for macOS
    • Block Update Notifications
    • Low End GPUs
    • Tips & Tricks (WIP)
  • Hackintosh Opinions
    • Olarila - Not Recommended
    • Hack Studio SFF
Powered by GitBook
On this page

Was this helpful?

Edit on GitHub
  1. Step-by-Step

Use Debug Versions

PreviousUSB Port MappingNextUpgrade OpenCore

Last updated 12 months ago

Was this helpful?

Switch to the Debug Version of OpenCore

  • Launch OCAuxiliaryTools and open the relevant Config.plist.

  • Modify the Config.plist debug settings as described here:

  • 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 click: Get the latest version of OpenCore

  • 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 license. Attribution by link to .

📗
OpenCore Debugging | OpenCore Install Guide
Creative Commons — Attribution-NonCommercial 4.0 International — CC BY-NC 4.0
chriswayg · GitHub