diff --git a/images/installer-guide/windows-install-md/gibMacOS-selection.png b/images/installer-guide/windows-install-md/gibMacOS-selection.png new file mode 100644 index 0000000000..3ddaab79da Binary files /dev/null and b/images/installer-guide/windows-install-md/gibMacOS-selection.png differ diff --git a/installation/installation-process.md b/installation/installation-process.md index c3dbc2b5e4..6402bb8214 100644 --- a/installation/installation-process.md +++ b/installation/installation-process.md @@ -26,6 +26,40 @@ All files in the Kexts folder end in .kext | Includes source code and folders config.plist found under EFI/OC | Neither renamed or placed the .plist in right location Only uses kexts that are needed | Downloaded every kext listed +# Recovery Environment Steps (Don't worry about these unless you followed the alternate method) + + Open Disk Utility + + Enable View -> Show All Devices + + Format the target device (not the volume) for your macOS version + + ◦ Sierra and prior should be macOS Extended (Journaled) with a GUID Partition Map + + ◦ High Sierra and newer should be APFS with a GUID Parititon Map + + Quit Disk Utility + + Open Terminal + + Type cd /Volumes/[your ExFAT volume name]/macOS + + ◦ You can get a list of all volumes with ls /Volumes + + ◦ Make sure to replace macOS with the name of the folder containing the gibMacOS files and UnPlugged.command + + Type ./UnPlugged.command to launch the script + + ◦ If that does not work - you can type bash UnPlugged.command + +# UnPlugged.command Steps (Don't worry about these unless you followed the alternate method) + + The script will list any detected Install macOS [version].app directories - select the one that matches the intended OS version to install (in most cases there will only be one detected) + The script should auto-detect the required files - but if it does not, it will prompt for the path to them here + The script will then prompt asking for the target volume - this is the volume that you just created in Disk Utility. The one where you intend to install macOS + Then you'll be presented with a task list - and asked if you want to continue - type y and enter + The script will build the full install app and launch it from the Terminal for you - continue the rest of the install as normal + ## Booting the OpenCore USB So you're now ready to finally put the USB stick into your computer and boot off of it. Remember that most laptops and some desktops will still default to the internal drive with Windows, and you'll need to manually select OpenCore in the BIOS boot options. You'll need to check in the user manual or use a bit of google to find out what Fn key accesses the BIOS and boot menu(ie. Esc, F2, F10 or F12) diff --git a/installer-guide/linux-install-alternate.md b/installer-guide/linux-install-alternate.md new file mode 100644 index 0000000000..2f74f40ab5 --- /dev/null +++ b/installer-guide/linux-install-alternate.md @@ -0,0 +1,34 @@ +# Making the installer in Linux (Alternate) + +While you don't need a fresh install of macOS to use OpenCore, some users prefer having a full installer. + +To start you'll need the following: + +* 16GB USB Stick (will vary depending on OS version, 16GB will work fine for latest) +* [gibMacOS](https://github.com/acidanthera/OpenCorePkg/releases) + * This will require Python 3 installed (should be preinstalled) +* [UnPlugged](https://github.com/corpnewt/UnPlugged) + +## Downloading macOS + +Now to start, first cd into [gibMacOS's folder](https://github.com/corpnewt/gibMacOS) and run one of the following commands: + + +```sh +# Adjust below command to the correct folder +cd ~/Downloads/gibMacOS/ +``` + +From here, you'll want to launch gibMacOS. +```sh +python py gibMacOS.py +``` +Now, based off of the image below, select the version you want. + +![](../images/installer-guide/windows-install-md/gibMacOS-selection.png) + +* **macOS 12 and above note**: As recent macOS versions introduce changes to the USB stack, it is highly advisable that you map your USB ports (with USBToolBox) before installing macOS. + * CAUTION: With macOS 11.3 and newer, [XhciPortLimit is broken resulting in boot loops](https://github.com/dortania/bugtracker/issues/162). + * If you've already [mapped your USB ports](https://dortania.github.io/OpenCore-Post-Install/usb/) and disabled `XhciPortLimit`, you can boot macOS 11.3+ without issues. + +## Now with all this done, head to [Setting up the EFI](./opencore-efi.md) to finish up your work diff --git a/installer-guide/windows-install-alternate.md b/installer-guide/windows-install-alternate.md new file mode 100644 index 0000000000..bdb5144374 --- /dev/null +++ b/installer-guide/windows-install-alternate.md @@ -0,0 +1,107 @@ +# Making the installer in Windows (Alternate) + +While you don't need a fresh install of macOS to use OpenCore, some users prefer having a full installer. + +To start you'll need the following: + +* 16GB USB Stick (will vary depending on OS version, 16GB will work fine for latest) +* [gibMacOS](https://github.com/corpnewt/GibMacOS) + * This will require [Python 3 installed](https://python.org/releases) +* [macrecovery.py](https://github.com/acidanthera/OpenCorePkg/releases) + * This will also require [Python 3 installed](https://python.org/releases) +* [UnPlugged](https://github.com/corpnewt/UnPlugged) + +## Downloading macOS + +Now to start, first open Command Prompt and cd into [gibMacOS's folder](https://github.com/corpnewt/gibMacOS), and run one of the following commands: + + +```sh +# Adjust below command to the correct folder +cd C:/Users/(username)/Downloads/gibMacOS-master/gibMacOS/ +``` + +From here, you'll want to launch gibMacOS. +```sh +python py gibMacOS.py +``` + +Now, based off of the image below, select the version you want. + +![](../images/installer-guide/windows-install-md/gibMacOS-selection.png) + +# Getting the recovery files + +To grab recovery installers is super easy, first grab a copy of [OpenCorePkg](https://github.com/acidanthera/OpenCorePkg/releases) and head to `/Utilities/macrecovery/`. Next, click next to the current folder path and type `cmd` to open a Command Prompt in the current directory: + +![](../images/installer-guide/windows-install-md/open-cmd-current-folder.gif) + + +Now run one of the following depending on what version of macOS you want (Note these scripts rely on [Python 3](https://www.python.org/downloads/) support, please install if you haven't already): + +```sh +# Lion (10.7): +python3 macrecovery.py -b Mac-2E6FAB96566FE58C -m 00000000000F25Y00 download +python3 macrecovery.py -b Mac-C3EC7CD22292981F -m 00000000000F0HM00 download + +# Mountain Lion (10.8): +python3 macrecovery.py -b Mac-7DF2A3B5E5D671ED -m 00000000000F65100 download + +# Mavericks (10.9): +python3 macrecovery.py -b Mac-F60DEB81FF30ACF6 -m 00000000000FNN100 download + +# Yosemite (10.10): +python3 macrecovery.py -b Mac-E43C1C25D4880AD6 -m 00000000000GDVW00 download + +# El Capitan (10.11): +python3 macrecovery.py -b Mac-FFE5EF870D7BA81A -m 00000000000GQRX00 download + +# Sierra (10.12): +python3 macrecovery.py -b Mac-77F17D7DA9285301 -m 00000000000J0DX00 download + +# High Sierra (10.13) +python3 macrecovery.py -b Mac-7BA5B2D9E42DDD94 -m 00000000000J80300 download +python3 macrecovery.py -b Mac-BE088AF8C5EB4FA2 -m 00000000000J80300 download + +# Mojave (10.14) +python3 macrecovery.py -b Mac-7BA5B2DFE22DDD8C -m 00000000000KXPG00 download + +# Catalina (10.15) +python3 macrecovery.py -b Mac-00BE6ED71E35EB86 -m 00000000000000000 download + +# Big Sur (11) +python3 macrecovery.py -b Mac-42FD25EABCABB274 -m 00000000000000000 download + +# Monterey (12) +python3 macrecovery.py -b Mac-FFE5EF870D7BA81A -m 00000000000000000 download + +# Latest version +# ie. Ventura (13) +python3 macrecovery.py -b Mac-4B682C642B45593E -m 00000000000000000 download +``` + +* **macOS 12 and above note**: As recent macOS versions introduce changes to the USB stack, it is highly advisable that you map your USB ports (with USBToolBox) before installing macOS. + * CAUTION: With macOS 11.3 and newer, [XhciPortLimit is broken resulting in boot loops](https://github.com/dortania/bugtracker/issues/162). + * If you've already [mapped your USB ports](https://dortania.github.io/OpenCore-Post-Install/usb/) and disabled `XhciPortLimit`, you can boot macOS 11.3+ without issues. + +This will take some time, however once you're finished you should get either BaseSystem or RecoveryImage files: + +![](../images/installer-guide/windows-install-md/macrecovery-done.png) + +# Building the full USB + + Format your USB with 2 partitions: + + ◦ A FAT32 partition of ~750MB to 1GB (enough to accommodate the EFI and com.apple.recovery.boot folders) + + ◦ An ExFAT partition of the remaining space (needs to be enough to accommodate the files downloaded from gibMacOS) + + Copy your EFI folder and the com.apple.recovery.boot folder over to the FAT32 partition + + Copy the folder containing the files downloaded from gibMacOS to the ExFAT partition + + ◦ You'll be cding to this folder later - so it may make sense to label it something easy to type like macOS + + Copy UnPlugged.command to that same folder on the ExFAT partition + +## Now with all this done, head to [Setting up the EFI](./opencore-efi.md) to finish up your work