Update guide

How to update OpenCore Legacy Patcher and macOS

Update OpenCore Legacy Patcher after a new release, or move a patched Mac through a macOS update without losing root patches.

Three-part update

Update the OCLP app, rebuild and install OpenCore, then reinstall root patches after macOS updates.

Major upgrades

Use a USB installer for major upgrades, such as Sonoma to Sequoia.

Automatic updates

Disable automatic macOS updates on OCLP systems to avoid staged update mismatches.

Update the app, OpenCore, and patches

  1. Step 1

    Update the application

    Install the latest OCLP release from the download page. Newer builds can notify you about updates and show the changelog.

  2. Step 2

    Update OpenCore

    After updating the app, rebuild OpenCore and install it to the internal disk or selected boot volume.

  3. Step 3

    Update or reinstall root patches

    macOS updates wipe root patches. Reinstall them after the updated system boots.

OCLP can notify you when an app update is available.
After updating the app, rebuild OpenCore and review patches.

Major macOS upgrades

For major upgrades such as Sonoma 14 to Sequoia 15, update OCLP, rebuild OpenCore to the internal disk, create a USB installer, install macOS without using Disk Utility if you want to keep data, and reinstall root patches afterward.

Use USB for major upgrades

Major upgrades may start from System Settings, but the USB path remains the safer recommended route.

Check the booted OpenCore and patcher versions before updates.
Confirm root patch status after macOS updates.

Minor macOS updates

For dot updates, update OCLP, rebuild OpenCore, start the update from System Settings, then reinstall root patches after the Mac finishes updating. If your system needs KDKSupportPkg or MetallibSupportPkg, keep an internet connection available.

  • Sequoia systems with Ivy Bridge, Haswell, or NVIDIA Kepler graphics may require MetallibSupportPkg.
  • Macs with AMD legacy GCN GPUs on Ventura or newer may require KDKSupportPkg.
  • If OCLP only patches WiFi first, reboot, connect to the internet, and run root patching again.

Disable automatic updates

Staged automatic updates can modify the system volume before installation completes. That mismatch often breaks root patching.

  • Ventura and newer: System Settings > General > Software Update > info button next to Automatic Updates > disable Download new updates when available.
  • Big Sur and Monterey: System Preferences > Software Update > Advanced > disable Download new updates when available.