diff --git a/docs/FAQ.md b/docs/FAQ.md index 99de679ad..5db9cb609 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -28,11 +28,9 @@ If you are feeling brave and don't mind having to possibly recover your system. ## Can I use automatic updates? -Apple has recently changed the way automatic updates work and it is extremely recommended to disable automatic updates (even downloading) when using OCLP. +It is extremely recommended to disable automatic updates (even downloading) when using OCLP, as Apple has recently changed the way automatic updates work. -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 as the operating system gets into a liminal state between two versions. If this happens to you, there is a "PurgePendingUpdate" tool currently available [on the Discord server](https://discord.com/channels/417165963327176704/1037474131526029362/1255993208966742108) you can download and then run it in Terminal, to get rid of a pending update. This may be integrated into OCLP later on, however there is currently no ETA. - -You can still manually initiate an update when you're ready to do so. +For a related "System version mismatch" error while root patching, refer to [this troubleshooting section](https://dortania.github.io/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html#system-version-mismatch-error-when-root-patching. ## Why is my system slow? diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md index c07e9ba0b..ed9232cf5 100644 --- a/docs/TROUBLESHOOTING.md +++ b/docs/TROUBLESHOOTING.md @@ -7,6 +7,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) +* [System version mismatch error when root patching](#system-version-mismatch-error-when-root-patching) * [Stuck on boot after root patching](#stuck-on-boot-after-root-patching) * ["Unable to resolve dependencies, error code 71" when root patching](#unable-to-resolve-dependencies-error-code-71-when-root-patching) * [Reboot when entering Hibernation (`Sleep Wake Failure`)](#reboot-when-entering-hibernation-sleep-wake-failure) @@ -78,6 +79,14 @@ 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. +## System version mismatch error when root patching + +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 as the operating system gets into a liminal state between two versions. + +Currently there is a "PurgePendingUpdate" tool currently available [on the Discord server](https://discord.com/channels/417165963327176704/1037474131526029362/1255993208966742108) you can download and then run it in Terminal, to get rid of a pending update. This may be integrated into OCLP later on, however there is currently no ETA. + +You can still manually initiate an update when you're ready to do so. + ## 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)