# Use Debug Versions

## Switch to the Debug Version of OpenCore

* Launch OCAuxiliaryTools and open the relevant Config.plist.
* Modify the Config.plist debug settings as described here: [OpenCore Debugging | OpenCore Install Guide](https://dortania.github.io/OpenCore-Install-Guide/troubleshooting/debug.html)

![](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2FyB0IOR1aRoecPEmxurXS%2FScreenshot%202024-06-04%20at%2011.24.45%20PM.png?alt=media\&token=55a7c4f8-2b20-4320-bf37-49150a9746ae)

* 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*

![](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2Ftq5PIWSU9jb0NnR41svq%2Fimage.png?alt=media\&token=28914431-4c11-45bf-9925-f821fa722432)

<figure><img src="https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2FMXwECGqG5dWyNXrXTIvR%2FScreenshot%202024-06-04%20at%2011.29.52%20PM.png?alt=media&#x26;token=c20bf17d-4945-488c-aef4-d2623002f4ea" alt=""><figcaption></figcaption></figure>

* Next, select *Menu -> Edit -> Upgrade OpenCore and Kexts* or click the *Upgrade OpenCore and Kexts* button.
* Then click: *Get the latest version of OpenCore*

![](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2FIL1MCtdkXnbsS9Njs5Z6%2FScreenshot%202024-06-04%20at%2011.33.42%20PM.png?alt=media\&token=8572b32b-d184-437f-bee6-871cd9ea054b)

* Then press the *Start Sync* button.

![](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2FwDXiedxctSU6SSs1gBm4%2FScreenshot%202024-06-04%20at%2011.33.42%20PM.png?alt=media\&token=501cc5f6-692b-41da-9f29-07868537f19a)

<figure><img src="https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2FxlCAtSqg5ETiguRraNMb%2FScreenshot%202024-06-04%20at%2011.32.26%20PM.png?alt=media&#x26;token=053f7f64-59f5-4d98-a4ba-c9c8f28549b0" alt=""><figcaption></figcaption></figure>

#### 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)

![](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2FFgodoVfQ9J7nzfXa4rSu%2Fby-nc-license.svg?alt=media\&token=03a208c0-37c6-488e-b564-b57cd43c75c9) *Except where otherwise noted, content on this site is licensed under the* [*Creative Commons — Attribution-NonCommercial 4.0 International — CC BY-NC 4.0*](https://creativecommons.org/licenses/by-nc/4.0/) *license. Attribution by link to* [*chriswayg · GitHub*](https://github.com/chriswayg)*.*