Skip to content

Commit

Permalink
Add troubleshooting for root patch reversion in recovery
Browse files Browse the repository at this point in the history
  • Loading branch information
ParaDoX1994 authored Oct 2, 2023
1 parent 67b00f3 commit aa7be21
Showing 1 changed file with 14 additions and 1 deletion.
15 changes: 14 additions & 1 deletion docs/TROUBLESHOOTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ Here are some common errors that users may experience while using this patcher:
* [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)
* [Infinite Recovery OS Booting](#infinite-recovery-os-reboot)
* [Stuck on boot after root patching](#stuck-on-boot-after-root-patching)
* [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)
* [Stuck on "Your Mac needs a firmware update"](#stuck-on-your-mac-needs-a-firmware-update)
Expand Down Expand Up @@ -51,6 +52,18 @@ With OpenCore Legacy Patcher, we rely on Apple Secure Boot to ensure OS updates

* Note: Machines with modified root volumes will also result in an infinite recovery loop until integrity is restored.

## 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
```
If your disk name is something else than "Macintosh HD", make sure to change the path accordingly.

Then restart and now your system should be restored to the unpatched snapshot and should be able to boot again.

## Reboot when entering Hibernation (`Sleep Wake Failure`)

[Known issue on some models](https://github.com/dortania/Opencore-Legacy-Patcher/issues/72), a temporary fix is to disable Hibernation by executing the following command in the terminal:
Expand Down Expand Up @@ -172,4 +185,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 aa7be21

Please sign in to comment.