Updating

This guide explains how to get fully up to date application, bootloader and patches.

Updating the application, OpenCore and patches

Latest versions of OCLP can download updates by themselves, you will get notified of a new update with the changelog.

You can also manually download the latest release here.

After the update, the application asks if you want to update OpenCore and root patches.

• If you do not need to change any settings, click "Yes" on the patch update question and follow the procedure to update OpenCore and root patches automatically.
  • If you do want to change settings, select "No" and do your settings.
  • In case you selected "No", you will have to manually build and install OpenCore and then manually install new root patches to ensure you're running on the latest OpenCore with your settings and the fixes for on-disk patches.

Checking OCLP and OpenCore versions

To check what version of OpenCore bootloader and the Patcher you're currently running, open the OCLP application and navigate to Settings -> App and look for "Booted Information". Alternatively you can check the version from Terminal using the following commands.

Check the status and version of root patches from Post Install Volume Patch section in the main menu.

# OpenCore Version
nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:opencore-version
# Patcher Version
nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:OCLP-Version

Preparing OCLP for macOS update

It is usually recommended to be on the latest OCLP version for macOS updates. This part details how to prepare OCLP for latest update.

Major upgrades

This part is for major upgrades, such as Sonoma (14) -> Sequoia (15)

1. Make sure the OCLP app is up to date.
2. After app has updated, rebuild OpenCore to the internal disk to update the bootloader.
   • You can also update root patches but this part is optional in this stage, as they will be wiped by the update.
3. Download the macOS version you want and create an installer USB drive using OCLP as detailed in the original Creating macOS Installers guide, then follow the Booting OpenCore and macOS guide boot to into the installer on your USB drive.
4. Start macOS installation and follow the process, do not use Disk Utility if you don't want to wipe your disk.
5. After installation, reinstall root patches.

Note: Major upgrades may work using System Settings but this is not recommended.

Minor updates

This part is for minor updates, which are also called the "dot updates". Such as 12.x, 13.x etc.

1. Make sure the OCLP app is up to date.
2. Rebuild OpenCore to the internal disk to update the bootloader.
   • You can also update root patches but this part is optional in this stage, as they will be wiped by the update.
3. Start update from System Settings.
   • If your system requires KDKSupportPkg, OCLP will start downloading it automatically as long as you are connected to the internet and have the background process enabled.
4. Once installed, go into OCLP app and reinstall root patches.

::: warning Important

Some systems on Sequoia require MetallibSupportPkg during root patching after an update, which requires internet connection to download. If OCLP doesn't see internet connection, it will first offer a patch for WiFi only. You will have to reboot, connect to the internet and rerun root patching for the rest of the patches.

:::