docs/DEBUG.md
For those who've hit an odd bug and are unsure if it's user error or within the patcher, we recommend asking on the OpenCore Patcher Paradise Discord Server for help.
The easiest way to debug yourself is via Patcher Settings. Here there are many different settings, however, the 3 main options that will help are:
When you've enabled these 3 options, rebuild OpenCore and install to your drive. This will provide much greater debug information as well as write logs to the EFI Partition.
With "Enable OpenCore DEBUG" set, on every boot there will be a .txt file generated on the EFI Partition. To grab these logs, download and run MountEFI:
<div align="left"> </div>Once you've mounted the EFI Partition of the drive you have macOS on, you should see some nice logs:
<div align="left"> </div>With "Enable Kext DEBUG" set, every boot will now have much more detailed logs stored in the OS. To get these logs, simply run the below command:
sudo dmesg > ~/Desktop/DMESG.txt
From there, you'll have a log on your desktop.
::: warning Currently issues have been disabled due to current events. You can continue to receive support in the OpenCore Patcher Paradise Discord Server, where there are active members of the community available. :::
Now that you have proper logs, you can now file issues with us. This is a reminder to include the following info:
Additionally, please search to see if the issue has been reported before. This avoids having duplicate issues.