Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add UnPlugged methods to Linux and Windows #445

Open
wants to merge 11 commits into
base: master
Choose a base branch
from
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
34 changes: 34 additions & 0 deletions installation/installation-process.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
34 changes: 34 additions & 0 deletions installer-guide/linux-install-alternate.md
Original file line number Diff line number Diff line change
@@ -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.
* <span style="color:red"> CAUTION: </span> 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
107 changes: 107 additions & 0 deletions installer-guide/windows-install-alternate.md
Original file line number Diff line number Diff line change
@@ -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.
* <span style="color:red"> CAUTION: </span> 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
Loading