Skip to content

Commit

Permalink
Add note about root patch 2nd run
Browse files Browse the repository at this point in the history
  • Loading branch information
ParaDoX1994 authored Nov 9, 2024
1 parent a863b5c commit 6643549
Showing 1 changed file with 17 additions and 14 deletions.
31 changes: 17 additions & 14 deletions docs/POST-INSTALL.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,6 +81,10 @@ OCLP will automatically root patch your system during a first time install **if

Users can also see whether applicable patches have been installed, date and version the system was root patched with in the Post-Install Menu.

* Note: In some cases OCLP may require packages to be obtained from the internet, such as KDK or MetallibSupprtPkg. In these cases OCLP may only install the WiFi driver on first patch run to ensure you can connect to the internet. Root patching has to be ran again to install the rest of the required patches after internet connection is established to obtain the required packages.

Check the affected systems and GPUs from the warnings below.

:::warning

If you need to use Migration Assistant to bring over data to your new macOS install, it is **highly recommended** to avoid restoring from inside Setup Assistant and waiting to install root patches until after the transfer is complete. If root patches were automatically installed, you can use the options available in the OCLP app to remove them.
Expand All @@ -96,23 +100,11 @@ For more information on how to restore a Time Machine backup, [refer to the guid
| ![](./images/OCLP-GUI-root-patch-update.png) | ![](./images/OCLP-GUI-Root-Patch-Status.png) |



### Running Post Install patches manually

If you're using OCLP v0.4.3 or earlier, or need to run the patcher manually, you can do so with the app. There is no harm in trying to run the Patcher, as without compatible hardware, nothing will be done. You can see below on whether your hardware needs root volume patching or not.

There is also an option to remove root patches, which may be required in some situations, such as switching GPUs in Mac Pros or using Migration Assistant.

| Listing Patches | Patching Finished |
| :--- | :--- |
| ![](./images/OCLP-GUI-Root-Patch.png) | ![](./images/OCLP-GUI-Root-Patch-Finished.png) |


:::warning

With macOS Sequoia, MetallibSupportPkg is required to be downloaded for all 3802 systems. OCLP will handle this as long as you're connected to the internet.
With macOS Sequoia, MetallibSupportPkg is required to be downloaded for all 3802-based systems. OCLP will handle this as long as you're connected to the internet.

Such systems include:
3802 based GPUs:

* NVIDIA
* Kepler (GTX 600 - 700 series)
Expand All @@ -137,6 +129,17 @@ Machines that require this are those with AMD Metal dGPUs:

:::

### Running Post Install patches manually

If you're using OCLP v0.4.3 or earlier, or need to run the patcher manually, you can do so with the app. There is no harm in trying to run the Patcher, as without compatible hardware, nothing will be done. You can see below on whether your hardware needs root volume patching or not.

There is also an option to remove root patches, which may be required in some situations, such as switching GPUs in Mac Pros or using Migration Assistant.

| Listing Patches | Patching Finished |
| :--- | :--- |
| ![](./images/OCLP-GUI-Root-Patch.png) | ![](./images/OCLP-GUI-Root-Patch-Finished.png) |


Below entries represent GPUs no longer natively supported, ie. requiring root volume patching with OpenCore Legacy Patcher:

:::details GPUs requiring patching in different macOS versions
Expand Down

0 comments on commit 6643549

Please sign in to comment.