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

Creating troubleshooting and Windows installation sections + Update dependencies #8

Open
wants to merge 79 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
79 commits
Select commit Hold shift + click to select a range
d76bae2
Clean the guide and creating the troubleshooting section
Mar 10, 2021
59f7991
Update package.json
Mar 10, 2021
3b77a37
Fix error
Mar 10, 2021
baf9c88
Merge branch 'master' of https://github.com/tiziodcaio/OpenCore-Multi…
Mar 10, 2021
68d2b3d
Update config.js
Mar 10, 2021
71d4c5a
Update config.js
Mar 10, 2021
c29f5cd
fix config.js
Mar 10, 2021
f19752c
Merge the two disclaimer
Mar 10, 2021
a87524a
Update README.md
Mar 10, 2021
2aad896
Update OC version script
Mar 10, 2021
f2f90a5
Update quick.md and troubleshooting
Mar 10, 2021
c2bc8f1
Add manualwin section
Mar 10, 2021
0ee43a7
Update files
Mar 10, 2021
3e4427f
Insert Windows 10 installation into the guide
Mar 10, 2021
ea31513
Adding WinRE guide
Mar 11, 2021
ff38985
Update summary
Mar 11, 2021
6f5d15f
Fix links
Mar 11, 2021
bb41f9e
Update QUICK.md
Mar 11, 2021
0564c45
Update Win.md
Mar 11, 2021
26da2e0
Update troubleshooting.md
Mar 11, 2021
2ebd152
Fix menus
Mar 11, 2021
185c9dc
Update Win.md
Mar 11, 2021
5960dab
Update troubleshooting.md
Mar 11, 2021
539cc6b
Update troubleshooting.md
Mar 11, 2021
3353b9d
fix spoiler
Mar 11, 2021
c5a8978
Update the guide for simplify it
Mar 12, 2021
e56327e
Update Win.md
Mar 12, 2021
5af110a
Update Winre paragraph
Mar 12, 2021
9937aef
Update guide
Mar 12, 2021
e2a6246
Move the mbr installation (incomplete) down
Mar 13, 2021
c61454a
Update Win.md
Mar 13, 2021
78ed65a
Update Win.md
Mar 14, 2021
eb8951a
Fix lines
Mar 14, 2021
99fb407
Fix lines
Mar 14, 2021
e0a667c
Merge branch 'master' of https://github.com/tiziodcaio/OpenCore-Multi…
Mar 14, 2021
67d09b9
Update README.md
Mar 14, 2021
b17906a
Update QUICK.md
Mar 14, 2021
59678a7
Update troubleshooting.md
Mar 14, 2021
ef0045e
Add troubleshooting link
Mar 14, 2021
debdfdf
Remove unexistent guide
Mar 14, 2021
d95616b
Move disclaimer section
Mar 14, 2021
ddc4213
Update troubleshooting.md
Mar 14, 2021
6d21e54
Update troubleshooting.md
Mar 14, 2021
0d264ae
Merge branch 'master' of https://github.com/tiziodcaio/OpenCore-Multi…
Mar 14, 2021
06f4941
Fix an error merging the file
Mar 14, 2021
104a0da
Update diffdisk.md
Mar 14, 2021
cfb487b
Update README.md
Mar 14, 2021
57f9925
Update troubleshooting.md
Mar 14, 2021
db2827d
Update QUICK.md
Mar 14, 2021
c0ae483
Update README.md
Mar 14, 2021
dfa848c
Update Win.md
Mar 14, 2021
084f690
Update Win.md
Mar 15, 2021
a50bd84
Note for Windows 7 or older
Mar 15, 2021
da4b589
Update suggestioned spaces and part.
Mar 15, 2021
cbda890
Merge branch 'master' of https://github.com/tiziodcaio/OpenCore-Multi…
Mar 15, 2021
94f032a
Add first screenshots
Mar 15, 2021
ce3d270
Update Win.md
Mar 15, 2021
ffcd4b1
Update Win.md
Mar 16, 2021
76009cf
Adding images
Mar 16, 2021
2541372
Update Win.md
Mar 16, 2021
5c26dd2
Update Win.md
Mar 16, 2021
b819be5
Update Win.md
Mar 16, 2021
487e99b
Update troubleshooting.md
Mar 17, 2021
9e5342f
Fix macos installation
Mar 20, 2021
ed03524
Add more screenshot
Mar 22, 2021
07c4bda
Adding more screenshot to troubleshooting
Mar 24, 2021
c118cab
Update Win.md
Apr 10, 2021
cf4615e
Update troubleshooting.md
Apr 10, 2021
f85d2f3
Make more clear about the sizes
Apr 13, 2021
464e063
Remove spoiler in favor of vuepress spoiler
Apr 14, 2021
5165158
Update dependencies
Apr 28, 2021
152d771
Update .gitignore
Apr 28, 2021
d4040ef
Update Win.md
May 5, 2021
9ecd1ce
Update Win.md
May 5, 2021
f4badfe
Lint
May 6, 2021
c0cd940
Add Linux section
invisibilitys Jul 25, 2021
c6e1486
Merge pull request #1 from invisibilitys/patch-4
Aug 26, 2021
4295d40
Remove legacy MBR stuff
Nov 11, 2021
3cdf1f2
Merge branch 'master' into master
Nov 11, 2021
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 1 addition & 2 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
_book/
.vuepress/dist
node_modules/
.vscode/
.DS_Store
package-lock.json
yarn.lock
yarn*
26 changes: 21 additions & 5 deletions .vuepress/config.js
Original file line number Diff line number Diff line change
Expand Up @@ -102,16 +102,15 @@ module.exports = {
children: [
['/Intro/Def', 'What is it?'],
['/Intro/Booting-part', 'UEFI? Legacy? CSM? What?'],
['/Intro/disc', 'Disclaimer'],
]

},
{
title: 'Multibooting Situations',
title: 'UEFI Multibooting',
collapsable: false,
sidebarDepth: 1,
children: [
['/empty/', 'Multibooting Situations'],
['/empty/', 'Empty Disk(s)'],
{
collapsable: false,
sidebarDepth: 1,
Expand All @@ -120,7 +119,7 @@ module.exports = {
['/empty/diffdisk', 'Multiple disks - multiple OSes'],
]
},
['/exist/', 'Existing Filled Disk'],
['/exist/', 'Existing Filled Disk(s)'],
{
collapsable: false,
sidebarDepth: 1,
Expand All @@ -131,19 +130,36 @@ module.exports = {
},
]

},
{
title: 'Troubleshooting',
collapsable: false,
sidebarDepth: 1,
children: [
['troubleshooting', 'Troubleshooting'],
]

},
{
title: 'OpenCore configuration',
collapsable: false,
sidebarDepth: 1,
children: [
['/oc/win', 'For Windows booting'],
['/oc/linux', 'For Linux booting'],
['/oc/duet', 'Installing OpenCore on a legacy system'],
['https://dortania.github.io/OpenCore-Post-Install/multiboot/bootstrap.html', 'Using LauncherOption'],
['https://dortania.github.io/OpenCore-Post-Install/multiboot/bootcamp.html', 'BootCamp installation'],
]

},
{
title: 'Windows 10 manual and automatic Installation',
collapsable: false,
sidebarDepth: 1,
children: [
['Win', 'Windows 10 manual and automatic Installation'],
]

},
],
},
Expand Down
16 changes: 8 additions & 8 deletions Intro/Booting-part.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Usually, 2012+ computers that came with Windows 8 would have a UEFI firmware (so
- Loads its integrated drivers and services
- Reads the boot menu entries and start loading the first boot entry
- If failed starts the next one
- Loads the bootloader
- Loads the bootloader
- OS is loaded after that.

Usually, the said "bootloader" is contained somewhere in the disk, and that somewhere is called a **EFI Partition**. You can find this named different things like ESP (EFI System Partition), SYSTEM, EFI, BOOT and so on. This partition is **FAT32** formatted and flagged as **EF00** in MBR or **C12A7328-F81F-11D2-BA4B-00A0C93EC93B** GUID in GPT. This partition contains usually the EFI applications (like an OS bootloader) in it that are loaded at boot by the UEFI firmware (remember this as it is important for later for recovery).
Expand All @@ -19,12 +19,12 @@ Contrary to UEFI, Legacy systems are older and much more mature (dating back to

These systems rely on another method of loading the bootloader. This piece of software is usually written in the first sectors of the disk (formatted as MBR) called **boot sector**, this sector is usually 512 or 4096 bytes big, the BIOS would then read the code, copy it to memory and then execute it, at that point an OS or Bootloader menu (like GRUB2) will show up:

* BIOS Starts up
* Reads the **boot sector**
* Loads the program into memory
* Executes the program
* Bootloader appears
* The OS will boot now.
- BIOS Starts up
- Reads the **boot sector**
- Loads the program into memory
- Executes the program
- Bootloader appears
- The OS will boot now.

# Major differences between the systems

Expand Down Expand Up @@ -68,7 +68,7 @@ Check **BIOS Mode**, it will either say **UEFI** or **Legacy**. Note that this i

### Method 1

On most Linux distributions, you can run
On most Linux distributions, you can run

```ls /sys/firmware/efi```

Expand Down
3 changes: 1 addition & 2 deletions Intro/Def.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,5 +19,4 @@ Now that you made the difference, there are thing you need to know about dualboo

But before starting any of this

# PLEASE BACKUP YOUR DATA.

# PLEASE BACKUP YOUR DATA
5 changes: 0 additions & 5 deletions Intro/disc.md

This file was deleted.

11 changes: 2 additions & 9 deletions QUICK.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,13 +33,6 @@ Ok, if you're quite experienced with how partitioning and booting multiple OSes
- If you're using linux it's the same steps as earlier (just 200MB EFI partition and somewhere to put macOS on)
- Make sure the disk doesn't have any S.M.A.R.T errors
- DO NOT have multiple EFIs on the same disk, you **MUST** only have **ONE** EFI partition per disk
- The OS Install order **does not matter at all**
- however windows can be a bit of a bitch, so installing it after macOS can be challenging, linux doesn't pose such problems
- If you happen to stumble on the sad windows crap you can:
- Boot windows installer
- Erase the partition where you want windows to be installed on to NTFS (as expected)
- Follow the rest from this [guide over at TenForums](https://www.tenforums.com/tutorials/84331-apply-windows-image-using-dism-instead-clean-install.html#Part2)
- You do NOT need MSR and Recovery, and you cannot create them when there are things already installed on the disk (blame windows installer)
- TODO: some way of creating a separate windows Recovery, I cannot find any guide on how to do that so that Windows would recognize it natively, if you know of a guide or know how to do it, open [a PR](https://github.com/dortania/OpenCore-Multiboot/) or [an issue](https://github.com/dortania/bugtracker) with your ideas.
- The OS Install order **does not matter at all**, however windows can be a bit of a bitch, so installing it after macOS can be challenging, linux doesn't pose such problems. [If you happen to stumble on the sad windows crap](./troubleshooting.md#Windows)

Now that you have all these information, good luck with the rest. However if you're not sure, follow then the long way that has more explanations and details on how to properly do it.
Now that you have all these information, good luck with the rest. However if you're not sure, follow then the long way that has more explanations and details on how to properly do it.
37 changes: 21 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Multiboot with OpenCore

Hello there! Looks like you're trying to get macOS and `$(OtherOS)` installed on your system, but you also do not want to mess `$(OtherOS)` or macOS in the process. You will be guided here through a multitude of steps to achieve just that while keeping the OS setups as unaffected as possible.
Hello there! Looks like you're trying to get macOS and `[OtherOS]` installed on your system, but you also do not want to mess `[OtherOS]` or macOS in the process. You will be guided here through a multitude of steps to achieve just that while keeping the OS setups as unaffected as possible.

## Firmware Types

Expand All @@ -11,19 +11,24 @@ Multibooting is greatly affected by the type of firmware you're running. This gu

The differences are minimal once you're using OpenCore but also it might be a bit difficult for the latter. Other than that, this guide will cover these elements:

1. What is multibooting and how does it work?
2. Partitioning vs Disk separating
1. Introduction to multi-booting
1. What is it?
2. UEFI? Legacy? CSM? What?
2. UEFI
1. One disk for all OSes
2. Different disks for different OSes
3. Legacy
1. One disk for all OSes
2. Different disks for different OSes
5. Troubleshooting
6. Tips and Tricks

### Disclaimer

We are not responsible for bricked devices, dead hard drives, thermonuclear war, or you getting fired because you got a kernel panic and didn't save your work. You are responsible for reading everything carefully before you do anything. Do your research and ask for support if you have any questions or issues before trying random things on the internet because "it's the internet". If you do, YOU are choosing to follow random things on the internet, and if YOU point the finger at us for messing up your device, WE will laugh at you.

Now that we got that out of our way let's get going, and good luck.
1. Multibooting on empty drives
1. One disk for all OSes
2. Different disks for different OSes
2. Multibooting on filled drives
1. One disk for all OSes
2. Different disks for different OSes
3. Opencore Configuration
1. For Linux booting
2. For Legacy/CSM/BIOS booting
4. Troubleshooting
5. Windows installation

## Disclaimer

We are not responsible for bricked devices, dead hard drives, thermonuclear war, or you getting fired because you got a kernel panic and didn't save your work. You are responsible for reading everything carefully before you do anything. Do your research and ask for support if you have any questions or issues before trying random things on the internet because "it's the internet". If you do, YOU are choosing to follow random things on the internet, and if YOU point the finger at us for messing up your device, WE will laugh at you.

So please backup your data and have a plan B in case things break (unlikely, but it happens more than you know).
120 changes: 120 additions & 0 deletions Win.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,120 @@
# Installation of Windows 10

**Work in Progess**, you can help contibute via [PRs](https://github.com/dortania/OpenCore-Multiboot/pulls). This guide referes to Windows 10, however it's still valid for Windows 8/8.1. (for Windows 7 or older, follow the legacy section (duetpkg configurations only))

## Downloading and flashing Windows 10

You can download Windows in different ways. In this guide we talk about Windows 10. So:

- [Downloading from MacOS/Linux](#MacOS/Linux)
- [Downloading from Windows](#Windows)

### Macos

Requirement:

- [Windows 10 ISO file](https://www.microsoft.com/software-download/windows10)
- An USB device

Download the appropriate ISO for your Country

Open Boot Camp Assistant and click on "Create a windows 10 device"

Wait until it finishes flashing, then boot on the USB.

### Linux

Requirement:

- [Windows 10 ISO file](https://www.microsoft.com/software-download/windows10)
- An USB device
At the moment use <https://github.com/WoeUSB/WoeUSB/tree/master> or dd

### Windows

Requirement:

- [MediaCreationTool](https://www.microsoft.com/software-download/windows10)
![Media Creation Tool Download page](./images/win-md/dlMediaCreationTool.png)
- [Rufus](https://rufus.ie)
- An USB device

Open MediaCreationTool and download the ISO file for your system (32 or 64 bits).

Open rufus, connect the usb and setup rufus with the appropriate settings for your system. Wait until it finishes of flashing, then boot on the USB.

![UEFI](/images/win-md/rufus.png)

## Installing Windows 10

![The usb booted up](/images/win-md/esd-iso.png)

When the usb booted, you can chose what to do:

- [Install Windows 10 automatically](#Automatically)
- [Install Windows 10 manually](#Manually) (only when there are problems or when you want to control the procedure)

### Automatically

Follow the procedure printed on screen!

![Installation image](/images/win-md/installation.png)

### Manually

This guide it's planned for a full installation. If you want to do a dualboot you can create the partition as you want. To open a terminal window use the key combo SHIFT-F10

Find and remember your path to install.esd/install.wim file. I suppose that `<path>` it will be its path.

#### Creating partitions

You have to choose:

- Create the partitions [automatically](#Automatically-partitions)
- Create the partition [manually](#Manually-partitions)

##### Automatically partitions

NOTE: This process can be followed only on blank disks.

Follow the procedure since appears this section:

![Custom installation](/images/win-md/custom.png)

Select "Custom", remove all partitions and finally click on "Create". Windows will ask you a confirm, then you did it!

##### Manually partitions

![Windows UEFI partitions](/images/win-md/part.png)

You can customize the commands (SHIFT+F10 to open Command Prompt) to your disk layout. If you felt more confortful, you could create all your partition (specify the size) on the diskmanagement screen (see [automatically](#Automatically-partitions)) and then installing manually (only blank disks).

Type `diskpart`

Type `list disk` and remember the disk number where you want to install Windows

Type `sel disk 0` where 0 is the number of your disk

Type `clean` to format the whole disk (optional)

Type `convert gpt` to convert the disk to GPT (it would give an error if it was already converted, no problem) (risk of lose your data!!!)

Type `create part efi size 200` to create the EFI partition (default size 200 MB), then type `format quick fs fat32` to format it and `assign letter q` to assign correctly our EFI partition.

Type `create part msr size 128` to create the MSR partition (default size 128 MB, shouldn't be changed; used by some strange Windows things).

Type `create part primary size 128000` to create the main partition (default size = [total space] - 450MB of WinRE - 128MB of MSR - 200MB of EFI. I remember that the size value must be in MB) --> default size = [total space] - 778MB, then type `format quick` to format it and `assign letter c` to assign correctly our drive.

After that we set up the recovery enviroment: type `create part primary` (default size 450, the remaining part of the disk), `set id de94bba4-06d1-4d40-a16a-bfd50179d6ac` to change the type of partition (primary-->WINRE, more infos [here](https://en.wikipedia.org/wiki/GUID_Partition_Table#Partition_type_GUIDs)),`gpt attributes 0x8000000000000001` to hide it,`format quick` to format it in NTFS.

Type `exit` to quit diskpart.

#### Install Windows

Type `dism /get-wiminfo /wimfile:<path>` to get the number of your edition.

Type `dism /apply-image /imagefile:<path> /index:4 /applydir:c:\` to flash the WIM/ESD image to your disk where 4 is changed as you edition number.

Type `bcdboot c:\windows /s q:\` to create the boot files on the EFI disk (Caution! if OpenCore was present, Windows cannot inject your EFI).

Reboot and hope everything work.
2 changes: 1 addition & 1 deletion empty/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,4 @@

This section will show you the tips and tricks of installing different OSes on empty drive(s) like on a newly built desktop or a FreeDOS laptop. It will contain information on the install order and technicalities of dualbooting. This is not limited to macOS only, it can be also helpful for multibooting other OSes with each other.

Let's get started...
Let's get started...
11 changes: 4 additions & 7 deletions empty/diffdisk.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,12 @@
I will not get too long in this part as it's the EASIEST one:

* Install macOS on one of the disks
* Install $(SECONDOS) on the other disk
* Install `[OtherOS]` on the other disk
* Install/copy OpenCore on the macOS disk EFI
* You're good to go

Things to keep in mind:

- Windows can be a bitch when it comes to multidisk setups (it freaks out when it sees a lot of EFI partitions on a lot of disks)
- If the above happens, disable/disconnect all the other disks and install windows as you would normally do
- For laptops this can be a pain, you can install windows manually by following [this guide from TenForums](https://www.tenforums.com/tutorials/84331-apply-windows-image-using-dism-instead-clean-install.html)
- Make sure you choose the proper disk
- You can still refer to other situations if you want to dualboot more than one OS on one of the disks.
- Make sure that OpenCore is on the same disk of macOS for easier troubleshooting and cleaner setup
* If you have issues, please see the [troubleshooting section](../troubleshooting.md)
* You can still refer to other situations if you want to dualboot more than one OS on one of the disks.
* Make sure that OpenCore is on the same disk of macOS for easier troubleshooting and cleaner setup
12 changes: 5 additions & 7 deletions empty/samedisk.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Basically, you only have one empty disk and you want to install multiple OSes to

- BACKUP YOUR DATA
- If possible, disconnect or disable any other disk/drive in your system, as it may interfere with the install procedure (especially windows')
- The drive isn't corrupted or have bad sectors
- The drive isn't corrupted or have bad sectors
- Stable power input

## Situation this applies for
Expand Down Expand Up @@ -36,21 +36,19 @@ Here is how it goes:
2. Once done, select "Partition", press "**+**" and choose the size of the other partition(s), "Format" MUST be `Mac OS Extended` or `APFS` (otherwise, macOS will convert the drive to hMBR which will break Windows installation).
![You can add as many partitions as you like, **Remember their sizes**](../images/disku2.png)
3. Hit Apply and let it do its thing:
* NOTE: on some macOS releases/setups, the disk utility may suddenly crash and send you back to the main menu, DO NOT PANIC (~~that sure helps~~), just wait for a minute or two then open disk utility back and check if the formatting is done.
- NOTE: on some macOS releases/setups, the disk utility may suddenly crash and send you back to the main menu, DO NOT PANIC (~~that sure helps~~), just wait for a minute or two then open disk utility back and check if the formatting is done.
4. Once done, you can install macOS on the partition of your choosing and continue along.

#### Note

* You can still do the above if you have macOS already installed, do NOT use bootcamp assistant.
* BootCamp assistant will add extra drivers to the Windows installer that we do not need.
- You can still do the above if you have macOS already installed, do NOT use bootcamp assistant.
- BootCamp assistant will add extra drivers to the Windows installer that we do not need.

### For the others

#### Windows

Windows can be a bit of a bitch when it comes to installing it as a second OS (like some kind of insult or just Microsoft doesn't realize that there are other OSes than Windows /s). Create your windows installer (on another computer with the windows creation disk utility or [Rufus](https://rufus.ie))

In case Windows has any issues while installing, boot back to the installer, remove the MSR/Recovery/Windows partitions that the installer made (there may be more, make sure you do not delete macOS or other OSes partitions), and follow [this guide over at TenForums](https://www.tenforums.com/tutorials/84331-apply-windows-image-using-dism-instead-clean-install.html) on how to install windows manually using the `dism` tool.
Create your windows installer (on another computer with the windows creation disk utility or [Rufus](https://rufus.ie)). If you have issues, please see the [troubleshooting section](../troubleshooting.md)

#### Linux

Expand Down
2 changes: 1 addition & 1 deletion exist/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,4 @@ This section will explain how to deal with disks with data already in use in the

This section is meant for those who have disks with an OS installed on it already, or just a secondary disk with partitions other than OSes. To be honest, either way, they both follow the same idea and procedures, but just to help with some special cases, it has been decided to split them into two different categories.

Let's get started...
Let's get started...
Loading