Skip to content

Commit 069f191

Browse files
authored
Add troubleshooting steps for missing EFI.
1 parent 0103501 commit 069f191

File tree

2 files changed

+20
-0
lines changed

2 files changed

+20
-0
lines changed

docs/TROUBLESHOOTING.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ Here are some common errors that users may experience while using this patcher:
88
* [Stuck on hard disk selection with greyed out buttons in installer](#stuck-on-hard-disk-selection-with-greyed-out-buttons-in-installer)
99
* [Cannot boot macOS without the USB](#cannot-boot-macos-without-the-usb)
1010
* [Infinite Recovery OS Booting](#infinite-recovery-os-reboot)
11+
* [Internal EFI missing when building OpenCore](#internal-efi-missing-when-building-opencore)
1112
* [System version mismatch error when root patching](#system-version-mismatch-error-when-root-patching)
1213
* [Stuck on boot after root patching](#stuck-on-boot-after-root-patching)
1314
* ["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
8687

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

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+
<div align="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.
103+
104+
<div align="left">
105+
<img src="./images/wipe-disk.png" alt="Wipe disk" width="800" />
106+
</div>
107+
108+
89109
## System version mismatch error when root patching
90110

91111
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.
202 KB
Loading

0 commit comments

Comments
 (0)