Skip to content

Commit

Permalink
Add troubleshooting step for removing root patches in recovery
Browse files Browse the repository at this point in the history
  • Loading branch information
ParaDoX1994 authored Oct 2, 2023
1 parent 99445cf commit 398740e
Showing 1 changed file with 12 additions and 1 deletion.
13 changes: 12 additions & 1 deletion docs/TROUBLESHOOTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ Here are some common errors that users may experience while using this patcher:
* [OpenCore Legacy Patcher not launching](#opencore-legacy-patcher-not-launching)
* [Stuck on `This version of Mac OS X is not supported on this platform` or (🚫) Prohibited Symbol](#stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform-or-(🚫)-prohibited-symbol)
* [Cannot boot macOS without the USB](#cannot-boot-macos-without-the-usb)
* [Stuck on boot after root patching](stuck-on-boot-after-root-patching)
* [Infinite Recovery OS Booting](#infinite-recovery-os-reboot)
* [Reboot when entering Hibernation (`Sleep Wake Failure`)](#reboot-when-entering-hibernation-sleep-wake-failure)
* [How to Boot Recovery through OpenCore Legacy Patcher](#how-to-boot-recovery-through-opencore-legacy-patcher)
Expand Down Expand Up @@ -45,6 +46,16 @@ After installing macOS, OpenCore Legacy Patcher should automatically prompt you

Reminder that once this is done, you'll need to select OpenCore in the boot picker again for your hardware to remember this entry and auto boot from then on.

## Stuck on boot after root patching

Boot into recovery by pressing space when your disk is selected on the OCLP bootpicker (if you have it hidden, hold ESC while starting up)
Go into terminal and type the following:
```sh
mount -uw /Volumes/Macintosh\ HD
bless --mount /Volumes/Macintosh\ HD --bootefi -last-sealed-snapshot
```
Then restart and now your system should be restored to the unpatched snapshot and should be able to boot again.

## Infinite Recovery OS Booting

With OpenCore Legacy Patcher, we rely on Apple Secure Boot to ensure OS updates work correctly and reliably with Big Sur. However this installs NVRAM variables that will confuse your Mac if not running with OpenCore. To resolve this, simply uninstall OpenCore and [reset NVRAM](https://support.apple.com/en-mide/HT201255).
Expand Down Expand Up @@ -172,4 +183,4 @@ Applicable models include:
| Mac Pro | Mid 2010 and older | MacPro3,1 - MacPro5,1 | |


![](../images/usb11-chart.png)
![](../images/usb11-chart.png)

0 comments on commit 398740e

Please sign in to comment.