Files
OpenCore-Legacy-Patcher/BOOT.html
2024-06-16 11:57:24 +00:00

41 lines
20 KiB
HTML

<!DOCTYPE html>
<html lang="en-US">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Booting OpenCore and macOS | OpenCore Legacy Patcher</title>
<meta name="generator" content="VuePress 1.9.10">
<link rel="&#39;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.14fef702.css" as="style"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/app.38528396.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/2.a6a015b9.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/1.f3b13868.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/20.deed3042.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/7.da13e42a.js" as="script"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/11.f2953214.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/12.24623920.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/13.751c5b09.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/14.8fcd7546.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/15.377a0153.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/16.6c3b9516.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/17.0032cc54.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/18.422bc3c3.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/19.deacfd2d.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/21.47a48cd9.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/22.3e67d06c.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/23.99938961.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/24.62291157.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/25.02bf41f5.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/26.fc4d21de.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/27.f2e8d6c3.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/28.3e023bd5.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/29.3f8f9d0d.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/3.f55f280a.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/30.19a6e072.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/31.5ebfd8da.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/32.0a79591e.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/33.1e009dc8.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/34.9afec66b.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/35.cc6c07b2.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/36.8b871dba.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/37.8a9c3ae6.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/38.898ed259.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/39.52dc124a.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/4.1c935dcd.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/40.0c128b1f.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/41.6ad5e52c.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/42.d56a34a6.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/43.5a1c7c13.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/44.1366556d.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/45.ea8f36ac.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/46.aafd5ccb.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/47.670f9e5a.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/48.58a49dbb.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/49.fc8c5375.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/5.d810afe6.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/6.0b612006.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/8.0bdcecdd.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/vendors~docsearch.c8990332.js">
<link rel="stylesheet" href="/OpenCore-Legacy-Patcher/assets/css/0.styles.14fef702.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 open"><span>Installation</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/BOOT.html" aria-current="page" class="active 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 Sonoma</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/SONOMA-DROP.html" class="sidebar-link">macOS Sonoma Support</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>macOS Ventura</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/VENTURA-DROP.html" class="sidebar-link">macOS Ventura Support</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"><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" class="sidebar-link">Troubleshooting</a></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 Patches</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 Windows in UEFI Mode</a></li><li><a href="/OpenCore-Legacy-Patcher/UNIVERSALCONTROL.html" class="sidebar-link">Universal Control on unsupported Macs</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 License</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/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><li><a href="/OpenCore-Legacy-Patcher/PROCESS.html" class="sidebar-link">Background process</a></li></ul></section></li></ul> </aside> <main class="page"> <div class="theme-succinct-content content__default"><h1 id="booting-opencore-and-macos"><a href="#booting-opencore-and-macos" class="header-anchor">#</a> Booting OpenCore and macOS</h1> <p>Now we finally get to boot OpenCore!</p> <p>Reboot the machine while holding <code>Option</code> to select the EFI Boot entry with the OpenCore icon (holding the <code>Control</code> key will make this the default boot entry):</p> <ul><li>This will be the Mac Boot Picker</li></ul> <p><img src="/OpenCore-Legacy-Patcher/assets/img/efi-boot.8307f610.png" alt=""></p> <details class="custom-block details"><summary>Note for Mac Pros/Xserves/iMacs with unflashed GPUs</summary> <p>(Adapted from the <a href="https://forums.macrumors.com/threads/opencore-on-the-mac-pro.2207814/" target="_blank" rel="noopener noreferrer">OpenCore on the Mac Pro guide<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> <p>For Mac Pro, Xserve and, iMac users with non-flashed GPUs, you can still easily boot OpenCore and view the entire boot process.</p> <p>Firstly, open the Terminal and run the following command:</p> <div class="language-sh extra-class"><pre class="language-sh"><code><span class="token function">sudo</span> nvram <span class="token string">&quot;recovery-boot-mode=unused&quot;</span> <span class="token operator">&amp;&amp;</span> <span class="token function">sudo</span> <span class="token function">reboot</span> recovery
</code></pre></div><p>This will make your machine reboot into the Recovery Environment. Alternatively, holding <code>Command</code> + <code>R</code> when your machine is starting up will also let you enter the Recovery.</p> <p>Secondly, open the Recovery Environment's Terminal (Menu bar &gt; Utilities &gt; Terminal).</p> <p>Now you'll want to get a list of drive identifiers. To do so, run the following command:</p> <div class="language-sh extra-class"><pre class="language-sh"><code>diskutil list
</code></pre></div><p>The command should produce a list of drives installed in your system:
<img src="/OpenCore-Legacy-Patcher/assets/img/Unflashed-Boot-1.ba0e58a4.png" alt=""></p> <p>Keep track of the drive with the OCLP install. You will need the drive identifer for later.</p> <p>Now you'll want to mount the EFI partition (where OCLP is installed, though it may differ if you've installed OCLP to a FAT-32 volume).</p> <p>Run the following command (Replace X with the drive number):</p> <div class="language-sh extra-class"><pre class="language-sh"><code>diskutil <span class="token function">mount</span> diskXs1
</code></pre></div><p><img src="/OpenCore-Legacy-Patcher/assets/img/Unflashed-Boot-2.5e873f39.png" alt="">
If everything is correct, the EFI partion should be mounted.</p> <p>Now you'll want to use the <code>bless</code> command to set the default boot device:</p> <div class="language-sh extra-class"><pre class="language-sh"><code>bless <span class="token parameter variable">--mount</span> /Volumes/EFI <span class="token parameter variable">--setBoot</span> <span class="token parameter variable">--file</span> /Volumes/EFI/System/Library/CoreServices/boot.efi
</code></pre></div><p>Once the command is run, it should produce no output.
<img src="/OpenCore-Legacy-Patcher/assets/img/Unflashed-Boot-3.79f71d03.png" alt=""></p> <p>If the command produces an output, ensure that you've typed it in correctly.</p> <p>Now you can reboot your machine. OCLP is now the default boot option!</p></details> <p>Now that you've loaded OpenCore, &quot;select Install macOS&quot;:</p> <ul><li>This will be the OpenCore Picker</li></ul> <p><img src="/OpenCore-Legacy-Patcher/assets/img/oc-boot.3c2bdab5.png" alt=""></p> <p>You will soon reach the installer screen! If you enabled verbose mode when building OCLP, a lot of text will run across the screen. From there, it's just like any normal macOS install. For an example of how the boot process looks, see the following video:</p> <ul><li><a href="https://www.youtube.com/watch?v=AN3zsbQV_n4" target="_blank" rel="noopener noreferrer">OpenCore Legacy Patcher Boot Process<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>If your Mac is looping back into the beginning of the setup after the first reboot, turn it off, start it again and hold <code>Option</code>. This time, select the option with a grey hard disk icon, it can say &quot;macOS Installer&quot; or the name you gave the disk during the installer process. Keep repeating this step after every reboot if necessary.</p> <p><img src="/OpenCore-Legacy-Patcher/assets/img/oclp-stuck-firstreboot.12edd7b4.png" alt=""></p> <div class="custom-block warning"><p class="custom-block-title">WARNING</p> <p><strong>MacBookPro11,3 Note</strong>: When booting macOS Monterey, you'll need to boot into safe mode if acceleration patches are not installed yet. <a href="https://github.com/dortania/OpenCore-Legacy-Patcher/issues/522" target="_blank" rel="noopener noreferrer">Otherwise, you'll hit a black screen due to missing NVIDIA drivers.<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> Safe Mode can be entered by holding <code>Shift + Enter</code> when selecting macOS Monterey in OCLP's Boot Menu.</p></div> <h1 id="once-installed-and-booting-head-to-post-installation"><a href="#once-installed-and-booting-head-to-post-installation" class="header-anchor">#</a> Once installed and booting, head to <a href="/OpenCore-Legacy-Patcher/POST-INSTALL.html">Post-Installation</a></h1></div> <footer class="page-edit"><div class="edit-link"><a href="https://github.com/dortania/OpenCore-Legacy-Patcher/edit/main/docs/BOOT.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">4/1/2024, 3:44:18 PM</span></div></footer> <div class="page-nav"><p class="inner"><span class="prev">
<a href="/OpenCore-Legacy-Patcher/BUILD.html" class="prev">
Building and installing OpenCore
</a></span> <span class="next"><a href="/OpenCore-Legacy-Patcher/POST-INSTALL.html">
Post-Installation
</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.38528396.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/2.a6a015b9.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/1.f3b13868.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/20.deed3042.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/7.da13e42a.js" defer></script>
</body>
</html>