> For the complete documentation index, see [llms.txt](https://chriswayg.gitbook.io/opencore-visual-beginners-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chriswayg.gitbook.io/opencore-visual-beginners-guide/step-by-step/oc-auxiliary-tools-debug.md).

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

![](/files/cj52A5sG7CIKTkwzzcjb)

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

![](/files/DWZqbsDTboe7iWwpN6am)

<figure><img src="/files/fajhE3bhOG8NyDYKoErw" 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*

![](/files/NPRNTK1bh9TUf2Qfd3c8)

* Then press the *Start Sync* button.

![](/files/Ng8mpVwG8oWE6PnSpYWx)

<figure><img src="/files/IuCm87IETQACV7DJf24F" 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)

![](/files/VDLZ0kYXe61yzDLS7T31) *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)*.*
