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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://chriswayg.gitbook.io/opencore-visual-beginners-guide/step-by-step/oc-auxiliary-tools-debug.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.