mirror of
https://github.com/dortania/OpenCore-Legacy-Patcher.git
synced 2026-04-15 05:08:20 +10:00
37 lines
31 KiB
HTML
37 lines
31 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en-US">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>Troubleshooting | OpenCore Legacy Patcher</title>
|
|
<meta name="generator" content="VuePress 1.7.1">
|
|
<link rel="'stylesheet" href="/OpenCore-Legacy-Patcher/styles/website.css">
|
|
<meta name="description" content="">
|
|
<meta name="theme-color" content="#3eaf7c">
|
|
<meta name="apple-mobile-web-app-capable" content="yes">
|
|
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
|
|
|
<link rel="preload" href="/OpenCore-Legacy-Patcher/assets/css/0.styles.1c47b1bb.css" as="style"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/app.a6c5f956.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/2.6dd1708a.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/8.593ea558.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/19.7286b316.js" as="script"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/10.8e635d76.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/11.052cd10f.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/12.2bfabbde.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/13.e047b7d2.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/14.8045c977.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/15.11dffb3f.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/16.f7df9336.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/17.2d9ac424.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/18.b9d76aef.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/20.242b6ddc.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/21.902a1f97.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/22.83741141.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/23.32ef2808.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/24.dcab3935.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/25.1a8f8cae.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/26.af73c60e.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/27.2284dbea.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/28.7f9bb206.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/29.af780b19.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/3.e55ab541.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/30.3f6c955f.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/4.a576943c.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/5.f8de07ca.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/6.be7e7340.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/7.83fd04cf.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/9.bbbed07e.js">
|
|
<link rel="stylesheet" href="/OpenCore-Legacy-Patcher/assets/css/0.styles.1c47b1bb.css">
|
|
</head>
|
|
<body>
|
|
<div id="app" data-server-rendered="true"><div class="theme-container"><header class="navbar"><div class="sidebar-button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 448 512" class="icon"><path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"></path></svg></div> <a href="/OpenCore-Legacy-Patcher/" class="home-link router-link-active"><img src="homepage.png" alt="OpenCore Legacy Patcher" class="logo"> <span class="site-name can-hide">OpenCore Legacy Patcher</span></a> <div class="links"><div class="search-box"><input aria-label="Search" autocomplete="off" spellcheck="false" value=""> <!----></div> <nav class="nav-links can-hide"> <div class="nav-item"><a role="button" aria-label="Switch to light mode" class="nav-link"><span>Switch theme</span></a></div> <a href="https://github.com/dortania/OpenCore-Legacy-Patcher/" target="_blank" rel="noopener noreferrer" class="repo-link">
|
|
GitHub
|
|
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></nav></div></header> <div class="sidebar-mask"></div> <aside class="sidebar"><nav class="nav-links"> <div class="nav-item"><a role="button" aria-label="Switch to light mode" class="nav-link"><span>Switch theme</span></a></div> <a href="https://github.com/dortania/OpenCore-Legacy-Patcher/" target="_blank" rel="noopener noreferrer" class="repo-link">
|
|
GitHub
|
|
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></nav> <ul class="sidebar-links"><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>Introduction</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/START.html" class="sidebar-link">What is OpenCore?</a></li><li><a href="/OpenCore-Legacy-Patcher/MODELS.html" class="sidebar-link">Supported Models</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>Setting up</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/INSTALLER.html" class="sidebar-link">Download and build macOS Installers</a></li><li><a href="/OpenCore-Legacy-Patcher/BUILD.html" class="sidebar-link">Building and installing OpenCore</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>Installation</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/BOOT.html" class="sidebar-link">Booting OpenCore and macOS</a></li><li><a href="/OpenCore-Legacy-Patcher/POST-INSTALL.html" class="sidebar-link">Post-Installation</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>macOS Monterey</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/MONTEREY-DROP.html" class="sidebar-link">macOS Monterey Support</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading open"><span>Misc</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/ACCEL.html" class="sidebar-link">Working Around Legacy Acceleration Issues</a></li><li><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html" aria-current="page" class="active sidebar-link">Troubleshooting</a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html#stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform" class="sidebar-link">Stuck on This version of Mac OS X is not supported on this platform</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html#cannot-boot-macos-without-the-usb" class="sidebar-link">Cannot boot macOS without the USB</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html#infinite-recovery-os-booting" class="sidebar-link">Infinite Recovery OS Booting</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html#reboot-when-entering-hibernation-sleep-wake-failure" class="sidebar-link">Reboot when entering Hibernation (Sleep Wake Failure)</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html#booting-with-a-non-flashed-gpu" class="sidebar-link">Booting with a non-flashed GPU</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html#how-to-boot-big-sur-recovery" class="sidebar-link">How to Boot Big Sur Recovery</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html#stuck-on-your-mac-needs-a-firmware-update" class="sidebar-link">Stuck on "Your Mac needs a firmware update"</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html#no-brightness-control" class="sidebar-link">No Brightness Control</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html#cannot-connect-wi-fi-on-monterey-with-legacy-cards" class="sidebar-link">Cannot connect Wi-Fi on Monterey with legacy cards</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html#no-graphics-acceleration" class="sidebar-link">No Graphics Acceleration</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html#black-screen-on-macbookpro11-3-in-macos-monterey" class="sidebar-link">Black Screen on MacBookPro11,3 in macOS Monterey</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html#no-displayport-output-on-mac-pros-with-nvidia-kepler" class="sidebar-link">No DisplayPort Output on Mac Pros with NVIDIA Kepler</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html#volume-hash-mismatch-error-in-macos-monterey" class="sidebar-link">Volume Hash Mismatch Error in macOS Monterey</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html#cannot-disable-sip-in-recoveryos" class="sidebar-link">Cannot Disable SIP in recoveryOS</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html#intermediate-issues-with-usb-1-1-and-bluetooth-on-macpro3-1-macpro5-1" class="sidebar-link">Intermediate issues with USB 1.1 and Bluetooth on MacPro3,1 - MacPro5,1</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html#stuck-on-less-than-a-minute-remaining" class="sidebar-link">Stuck on "Less than a minute remaining..."</a></li></ul></li><li><a href="/OpenCore-Legacy-Patcher/DEBUG.html" class="sidebar-link">How to debug with OpenCore</a></li><li><a href="/OpenCore-Legacy-Patcher/UPDATE.html" class="sidebar-link">Updating OpenCore and Co</a></li><li><a href="/OpenCore-Legacy-Patcher/UNINSTALL.html" class="sidebar-link">Uninstalling OpenCore</a></li><li><a href="/OpenCore-Legacy-Patcher/ICNS.html" class="sidebar-link">Creating custom icons for OpenCore and Mac Boot Picker</a></li><li><a href="/OpenCore-Legacy-Patcher/WINDOWS.html" class="sidebar-link">Installing UEFI Windows 10</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>Credit</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/DONATE.html" class="sidebar-link">Supporting the patcher</a></li><li><a href="/OpenCore-Legacy-Patcher/LICENSE.html" class="sidebar-link">OpenCore Legacy Patcher Licence</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>Documentation</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/ISSUES-HOLD.html" class="sidebar-link">The current hold on new issues and pull requests</a></li><li><a href="/OpenCore-Legacy-Patcher/TESTED.html" class="sidebar-link">Tested Models on OpenCore Legacy Patcher</a></li><li><a href="/OpenCore-Legacy-Patcher/TERMS.html" class="sidebar-link">OpenCore Patcher Terminology</a></li><li><a href="/OpenCore-Legacy-Patcher/HOW.html" class="sidebar-link">Boot Process with OpenCore Legacy Patcher</a></li><li><a href="/OpenCore-Legacy-Patcher/PATCHEXPLAIN.html" class="sidebar-link">Explaining the patches in OpenCore Legacy Patcher</a></li></ul></section></li></ul> </aside> <main class="page"> <div class="theme-succinct-content content__default"><h1 id="troubleshooting"><a href="#troubleshooting" class="header-anchor">#</a> Troubleshooting</h1> <p>Here are some common errors users may experience while using this patcher:</p> <ul><li><a href="#stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform">Stuck on <code>This version of Mac OS X is not supported on this platform</code></a></li> <li><a href="#cannot-boot-macos-without-the-usb">Cannot boot macOS without the USB</a></li> <li><a href="#infinite-recovery-os-reboot">Infinite Recovery OS Booting</a></li> <li><a href="#reboot-when-entering-hibernation-sleep-wake-failure">Reboot when entering Hibernation (<code>Sleep Wake Failure</code>)</a></li> <li><a href="#booting-with-a-non-flashed-gpu">Booting with a non-flashed GPU</a></li> <li><a href="#how-to-boot-big-sur-recovery">How to Boot Big Sur Recovery</a></li> <li><a href="#stuck-on-your-mac-needs-a-firmware-update">Stuck on "Your Mac needs a firmware update"</a></li> <li><a href="#no-brightness-control">No Brightness Control</a></li> <li><a href="#cannot-connect-Wi-Fi-on-Monterey-with-legacy-cards">Cannot connect Wi-Fi on Monterey with legacy cards</a></li> <li><a href="#no-graphics-acceleration">No Graphics Acceleration</a></li> <li><a href="#black-screen-on-macbookpro113-in-macos-monterey">Black Screen on MacBookPro11,3 in macOS Monterey</a></li> <li><a href="#no-displayport-output-on-mac-pros-with-NVIDIA-kepler">No DisplayPort Output on Mac Pros with NVIDIA Kepler</a></li> <li><a href="#volume-hash-mismatch-error-in-macos-monterey">Volume Hash Mismatch Error in macOS Monterey</a></li> <li><a href="#cannot-disable-sip-in-recoveryos">Cannot Disable SIP in recoveryOS</a></li> <li><a href="#stuck-on-less-than-a-minute-remaining">Stuck on "Less than a minute remaining..."</a></li></ul> <h2 id="stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform"><a href="#stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform" class="header-anchor">#</a> Stuck on <code>This version of Mac OS X is not supported on this platform</code></h2> <p>This means macOS has detected a SMBIOS it does not support, to resolve this ensure you're booting OpenCore <strong>before</strong> the macOS installer in the boot picker. Reminder the option will be called <code>EFI Boot</code></p> <p>Once you've booted OpenCore at least once, your hardware should now auto boot it until either NVRAM reset or you remove the drive with OpenCore installed.</p> <h2 id="cannot-boot-macos-without-the-usb"><a href="#cannot-boot-macos-without-the-usb" class="header-anchor">#</a> Cannot boot macOS without the USB</h2> <p>By default, the OpenCore Patcher won't install OpenCore onto the internal drive itself during installs. Instead, you'll need to either <a href="https://dortania.github.io/OpenCore-Post-Install/universal/oc2hdd.html" target="_blank" rel="noopener noreferrer">manually transfer<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a> OpenCore to the internal drive's EFI or run this patcher's Option 2 again but select your internal drive.</p> <p>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.</p> <h2 id="infinite-recovery-os-booting"><a href="#infinite-recovery-os-booting" class="header-anchor">#</a> Infinite Recovery OS Booting</h2> <p>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, simply uninstall OpenCore and <a href="https://support.apple.com/en-mide/HT201255" target="_blank" rel="noopener noreferrer">reset NVRAM<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a>.</p> <ul><li>Note: Machines with modded root volumes will also result in infinite recovery until integrity is restored</li></ul> <h2 id="reboot-when-entering-hibernation-sleep-wake-failure"><a href="#reboot-when-entering-hibernation-sleep-wake-failure" class="header-anchor">#</a> Reboot when entering Hibernation (<code>Sleep Wake Failure</code>)</h2> <p><a href="https://github.com/dortania/Opencore-Legacy-Patcher/issues/72" target="_blank" rel="noopener noreferrer">Known issue on some models<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a>, temporary fix is to disable Hibernation:</p> <div class="language- extra-class"><pre class="language-text"><code>sudo pmset -a hibernatemode 0
|
|
</code></pre></div><h2 id="booting-with-a-non-flashed-gpu"><a href="#booting-with-a-non-flashed-gpu" class="header-anchor">#</a> Booting with a non-flashed GPU</h2> <p>For Mac Pro, Xserve and iMac users with non-flashed GPUs, you can still easily boot OpenCore and view the entire boot process. To do so, make sure SIP is disabled(to allow NVRAM write access) and run the following:</p> <div class="language-sh extra-class"><pre class="language-sh"><code><span class="token function">sudo</span> bless --verbose --file /Volumes/VOLNAME/EFI/OC/OpenCore.efi --folder /Volumes/VOLNAME/EFI/OC --setBoot
|
|
</code></pre></div><ul><li>Note you will need to replace <code>VOLNAME</code> with the Volume name of your USB or hard drive with OpenCore</li> <li>Note 2: Once done, you can re-enable SIP</li> <li>Note 3: The EFI partition OpenCore was installed on must be mounted, if it's unmounted simply rerun "Install OpenCore to drive"</li></ul> <p>Once you boot OpenCore for the first time, LauncherOption will install itself as the top boot priority making OpenCore always launch. Combined with <code>RequestBootVar</code>, all boot options must go through OpenCore ensuring seamless usage even with OS installation and updates.</p> <h2 id="how-to-boot-big-sur-recovery"><a href="#how-to-boot-big-sur-recovery" class="header-anchor">#</a> How to Boot Big Sur Recovery</h2> <p>By default, the patcher will try to hide extra boot options such as recovery from the user. To make them appear, simply press the "Spacebar" inside OpenCore's Picker to list all boot options.</p> <h2 id="stuck-on-your-mac-needs-a-firmware-update"><a href="#stuck-on-your-mac-needs-a-firmware-update" class="header-anchor">#</a> Stuck on "Your Mac needs a firmware update"</h2> <p>Full error: "Your Mac needs a firmware update in order to install to this Volume. Please select a Mac OS Extended (Journaled) volume instead."</p> <p>This error occurs when macOS determines the firmware to not have full APFS support. To resolve is quite simple, when building OpenCore head to "Patcher Settings" and enable "Moderate SMBIOS Patching" or higher. This will ensure that the firmware reported will show as supporting full APFS capabilities.</p> <h2 id="no-brightness-control"><a href="#no-brightness-control" class="header-anchor">#</a> No Brightness Control</h2> <p>With OCLP v0.0.22, we've added support for brightness control on many models. However some users may have noticed that their brightness keys do not work.</p> <p>To work-around, we recommend user try out the below app:</p> <ul><li><a href="https://actproductions.net/free-apps/brightness-slider/" target="_blank" rel="noopener noreferrer">Brightness Slider<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></li></ul> <h2 id="cannot-connect-wi-fi-on-monterey-with-legacy-cards"><a href="#cannot-connect-wi-fi-on-monterey-with-legacy-cards" class="header-anchor">#</a> Cannot connect Wi-Fi on Monterey with legacy cards</h2> <p>With OCLP v0.2.5, we've added support for legacy Wi-Fi on Monterey. However some users may have noticed that they can't connect to wireless networks.</p> <p>To work-around, we recommend users to manually connect using the "other" option on the Wi-Fi menu bar or manually adding the network on the "Network" preference pane.</p> <h2 id="no-graphics-acceleration"><a href="#no-graphics-acceleration" class="header-anchor">#</a> No Graphics Acceleration</h2> <p>In macOS, each release generally means GPU drivers are dropped from the OS. With macOS Big Sur, currently all non-Metal GPUs require additional patches to gain acceleration. In addition, macOS Monterey removed Graphics Drivers for both Intel Ivy Bridge and NVIDIA Kepler.</p> <p>If you're using OCLP v0.4.4, you should have been prompted to install Root Volume patches after first boot from installation of macOS. If you need to do this manually, you can within our app. Once rebooted, acceleration will be re-enabled as well as brightness control for laptops.</p> <h2 id="black-screen-on-macbookpro11-3-in-macos-monterey"><a href="#black-screen-on-macbookpro11-3-in-macos-monterey" class="header-anchor">#</a> Black Screen on MacBookPro11,3 in macOS Monterey</h2> <p>Due to Apple dropping NVIDIA Kepler support in macOS Monterey, <a href="https://github.com/dortania/OpenCore-Legacy-Patcher/issues/522" target="_blank" rel="noopener noreferrer">MacBookPro11,3's GMUX has difficulties switching back to the iGPU to display macOS correctly.<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a> To work-around this issue, boot the MacBookPro11,3 in Safe Mode and once macOS is installed, run OCLP's Post Install Root Patches to enable GPU Acceleration for the NVIDIA dGPU.</p> <ul><li>Safe Mode can be started by holding Shift+Enter when selecting macOS Monterey in OCLP's Boot Menu.</li></ul> <h2 id="no-displayport-output-on-mac-pros-with-nvidia-kepler"><a href="#no-displayport-output-on-mac-pros-with-nvidia-kepler" class="header-anchor">#</a> No DisplayPort Output on Mac Pros with NVIDIA Kepler</h2> <p>If you're having troubles with DisplayPort output on Mac Pros, try enabling Minimal Spoofing in Settings -> SMBIOS Settings and rebuild/install OpenCore. This will trick macOS drivers into thinking you have a newer MacPro7,1 and play nicer.</p> <p><img src="/OpenCore-Legacy-Patcher/assets/img/OCLP-GUI-SMBIOS-Minimal.1e3c25a2.png" alt=""></p> <h2 id="volume-hash-mismatch-error-in-macos-monterey"><a href="#volume-hash-mismatch-error-in-macos-monterey" class="header-anchor">#</a> Volume Hash Mismatch Error in macOS Monterey</h2> <p>A semi-common popup some users face is the "Volume Hash Mismatch" error:</p> <p align="center"><img src="/OpenCore-Legacy-Patcher/assets/img/Hash-Mismatch.add9f660.png"></p> <p>What this error signifies is that the OS detects the boot volume's hash does not match to what the OS detects, this error is generally cosmetic and can be ignored. However if your system starts to crash spontaneously shortly after, you'll want to reinstall macOS fresh without importing any data at first.</p> <ul><li>Note that this bug affects native Macs as well and is not due to issues with unsupported Macs: <a href="https://osxdaily.com/2021/11/10/volume-hash-mismatch-error-in-macos-monterey/" target="_blank" rel="noopener noreferrer">OSX Daily: “Volume Hash Mismatch” Error in MacOS Monterey<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></li></ul> <p>Additionally it can help to disable FeatureUnlock in Settings -> Misc Settings as this tool can be strenuous on systems with weaker memory stability.</p> <h2 id="cannot-disable-sip-in-recoveryos"><a href="#cannot-disable-sip-in-recoveryos" class="header-anchor">#</a> Cannot Disable SIP in recoveryOS</h2> <p>With OCLP, the patcher will always overwrite the current SIP value on boot to ensure that users don't brick an installation after NVRAM reset. However for users wanting to disable SIP entirely, this can be done easily.</p> <p>Head into the GUI, Patcher Settings and toggle the bits you need disabled from SIP:</p> <table><thead><tr><th style="text-align:left;">SIP Enabled</th> <th style="text-align:left;">SIP Lowered (Root Patching)</th> <th style="text-align:left;">SIP Disabled</th></tr></thead> <tbody><tr><td style="text-align:left;"><img src="/OpenCore-Legacy-Patcher/assets/img/OCLP-GUI-Settings-SIP-Enabled.53d6d837.png" alt=""></td> <td style="text-align:left;"><img src="/OpenCore-Legacy-Patcher/assets/img/OCLP-GUI-Settings-SIP-Root-Patch.23121f6d.png" alt=""></td> <td style="text-align:left;"><img src="/OpenCore-Legacy-Patcher/assets/img/OCLP-GUI-Settings-SIP-Disabled.d9346b10.png" alt=""></td></tr></tbody></table> <h2 id="intermediate-issues-with-usb-1-1-and-bluetooth-on-macpro3-1-macpro5-1"><a href="#intermediate-issues-with-usb-1-1-and-bluetooth-on-macpro3-1-macpro5-1" class="header-anchor">#</a> Intermediate issues with USB 1.1 and Bluetooth on MacPro3,1 - MacPro5,1</h2> <p>For those experiencing issues with USB 1.1 devices (such as mice, keyboards and bluetooth chipsets), macOS Big Sur and newer have weakened OS-side reliability for the UHCI controller in older Mac Pros.</p> <ul><li>UHCI is a USB 1.1 controller that is hooked together with the USB 2.0 ports in your system. Whenever a USB 1.1 device is detected, the UHCI controller is given ownership of the device at a hardware/firmware level.
|
|
<ul><li>EHCI is the USB 2.0 controller in older Mac Pros</li></ul></li></ul> <p>Because of this, we recommend placing a USB 2.0/3.0 hub between your devices and the port on the Mac Pro. UHCI and EHCI cannot both be used at once, so using a USB hub will always force the EHCI controller on.</p> <ul><li>Alternatively, you can try cold starting the hardware and see if macOS recognizes the UHCI controller properly</li></ul> <h2 id="stuck-on-less-than-a-minute-remaining"><a href="#stuck-on-less-than-a-minute-remaining" class="header-anchor">#</a> Stuck on "Less than a minute remaining..."</h2> <p>A common area for systems to get "stuck", namely for units that are missing the <code>AES</code> CPU instruction/older mobile hardware. During this stange a lot of heavy cryptography is performed, which can make systems appear to be stuck when in reality they are working quite hard to finish up the installation.</p> <p>Because this step can take a few hours or more depending on drive speeds, be patient at this stage and do not manually reboot your machine as this will break the installation and require you to reinstall. If you think your system has stalled, press the Caps Lock key. If the light turns on, your system is busy.</p></div> <footer class="page-edit"><div class="edit-link"><a href="https://github.com/dortania/OpenCore-Legacy-Patcher/edit/main/docs/TROUBLESHOOTING.md" target="_blank" rel="noopener noreferrer">Help us improve this page!</a> <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></div> <div class="last-updated"><span class="prefix">Last Updated:</span> <span class="time">5/14/2022, 9:37:55 PM</span></div></footer> <div class="page-nav"><p class="inner"><span class="prev">
|
|
⟵
|
|
<a href="/OpenCore-Legacy-Patcher/ACCEL.html" class="prev">
|
|
Working Around Legacy Acceleration Issues
|
|
</a></span> <span class="next"><a href="/OpenCore-Legacy-Patcher/DEBUG.html">
|
|
How to debug with OpenCore
|
|
</a>
|
|
⟶
|
|
</span></p></div> </main></div><div class="global-ui"><div style="visibility:hidden;display:none;"></div><!----></div></div>
|
|
<script src="/OpenCore-Legacy-Patcher/assets/js/app.a6c5f956.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/2.6dd1708a.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/8.593ea558.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/19.7286b316.js" defer></script>
|
|
</body>
|
|
</html>
|