You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/TROUBLESHOOTING.md
+20Lines changed: 20 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,6 +8,7 @@ Here are some common errors that users may experience while using this patcher:
8
8
*[Stuck on hard disk selection with greyed out buttons in installer](#stuck-on-hard-disk-selection-with-greyed-out-buttons-in-installer)
9
9
*[Cannot boot macOS without the USB](#cannot-boot-macos-without-the-usb)
10
10
*[Infinite Recovery OS Booting](#infinite-recovery-os-reboot)
11
+
*[Internal EFI missing when building OpenCore](#internal-efi-missing-when-building-opencore)
11
12
*[System version mismatch error when root patching](#system-version-mismatch-error-when-root-patching)
12
13
*[Stuck on boot after root patching](#stuck-on-boot-after-root-patching)
13
14
*["Unable to resolve dependencies, error code 71" when root patching](#unable-to-resolve-dependencies-error-code-71-when-root-patching)
@@ -86,6 +87,25 @@ With OpenCore Legacy Patcher, we rely on Apple Secure Boot to ensure OS updates
86
87
87
88
* Note: Machines with modified root volumes will also result in an infinite recovery loop until integrity is restored.
88
89
90
+
## Internal EFI missing when building OpenCore
91
+
92
+
If you're using a brand new disk that has not been used before or was never formatted in any macOS type, you may face the following error in OCLP when trying to build on the internal disk.
93
+
94
+
<divalign="left">
95
+
<img src="./images/OCLP_Failed_to_find_applicable_disks.png" alt="Failed to find applicable disks" width="800" />
96
+
</div>
97
+
98
+
There are two ways to to try and resolve this.
99
+
100
+
1. Create a new FAT32 partition using Disk Utility, sized at around 100MB, naming does not matter. OpenCore will detect it and you will be able to build your EFI there.
101
+
102
+
2. When installing macOS, choose "View -> Show all devices" in Disk Utility and format the entire disk by choosing the topmost option in the sidebar.
## System version mismatch error when root patching
90
110
91
111
Updates from now on modify the system volume already while downloading, which can lead to broken patches out of a sudden as well as a "version mismatch" error while root patching, since the operating system gets into a liminal state between two versions. The "version mismatch" error is a safeguard preventing OCLP from patching on a system that is in a weird liminal state, to avoid leading to a very likely boot failure.
0 commit comments