# General Troubleshooting

This section is for those having issues booting either OpenCore, macOS or having issues inside macOS. If you're confused as to where exactly in the macOS boot process you're stuck, reading the macOS Boot Process page can help clarify things.

And if your issue is not covered, please read the official OpenCore documentation: Configuration.pdf (opens new window). This document goes into much more technical detail around how OpenCore works and has much more detailed info on all supported quirks.

DANGER

Only reset your NVRAM when troubleshooting when it's really needed and safe. DON'T RESET NVRAM on hardwares that can't do NVRAM reset (ie. Lenovo laptops (opens new window)), if you need to delete variables in NVRAM, add the values in NVRAM -> Delete (in your config.plist) instead for those hardwares

# Table of Contents

If you're unsure where you're currently stuck, please see here: Understanding the macOS Boot Process

  • OpenCore Boot Issues
    • This section refers to booting the actual USB and getting to OpenCore's picker. Anything after the picker, like booting macOS, should see below
  • Kernelspace Issues
    • Covering everything that many occur in early boot from the moment you select macOS in the OpenCore menu, till the point right before the Apple logo and the installer GUI loads
  • Userspace Issues
    • Covering the process from loading macOS's GUI to installing macOS on the drive
  • Post-Install Issues
    • Covering issues once macOS has been installed and is fully booted
  • Miscellaneous Issues
    • Covering issues after macOS's installation or with other OSes