Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
9 changes: 8 additions & 1 deletion .vuepress/config.js
Original file line number Diff line number Diff line change
Expand Up @@ -279,9 +279,16 @@ module.exports = {
children: [
'/extras/kaslr-fix',
'/extras/spoof',
'/extras/ventura',
['https://github.com/dortania/OpenCore-Install-Guide/tree/master/clover-conversion', 'Clover Conversion'],
'/extras/smbios-support.md',

]
},
{
title: 'OS Specific',
collapsable: false,
children: [
'/extras/tahoe',
]
},
{
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ actionLink: prerequisites.md

meta:
- name: description
content: Current supported version 1.0.2
content: Current supported version 1.0.5
---

# What is OpenCore and who is this guide for
Expand Down
3 changes: 2 additions & 1 deletion config.plist/security.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ These settings in your config.plist can restrict which macOS versions OpenCore w
OpenCore by default has [Apple Secure Boot](https://dortania.github.io/OpenCore-Post-Install/universal/security/applesecureboot.html#what-is-apple-secure-boot) enabled.
This enables security features such as the verification of macOS' `boot.efi`, with the side effect of restricting which macOS versions OpenCore will boot.

* Big Sur and Above (11.0+): The recommended value is `Default`.
* Sonoma to Tahoe (14.4 - 26.x): To be able to update, set to `Disabled`. For more information, check the `OTA Updates` section of [Tahoe](../extras/tahoe.md).
* Big Sur to Sonoma (11.0 - 14.3): The recommended value is `Default`.
* High Sierra-Catalina (10.13-10.15):
* If your model is not listed below, set to `Disabled`.
* If running NVIDIA Web Drivers, set to `Disabled`.
Expand Down
2 changes: 1 addition & 1 deletion extras/kaslr-fix.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Fixing KASLR slide values

This section is for users who wish to understand and fix "Couldn't allocate runtime area" errors. This is most common with either Z390, X99 and X299.
This section is for users who wish to understand and fix "Couldn't allocate runtime area" errors. This is most common with Z390, X99 and X299.

* Note: OpenCore is required, Clover is no longer supported in this guide

Expand Down
47 changes: 47 additions & 0 deletions extras/tahoe.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
# macOS 26: Tahoe

## Table of Contents

[[toc]]

## Prerequisites

### Analog Audio

AppleHDA.kext is no longer present in macOS 26, resulting in AppleALC not working. This means that analog sound through Realtek, Conexant, and similar sound chips will not work through built-in speakers and headphone jacks.

If you were previously using audio through a digital source (like HDMI, DP, or a USB adapter), then they will continue to work. No changes need to be made to your configuration.

Getting analog audio working again requires the injection of kexts which rely on lowered SIP restrictions.
It is possible to modify the root volume to reinject AppleHDA, but it has the same caveats that OCLP use on Hackintoshes has. You can also use [VoodooHDA](https://github.com/CloverHackyColor/VoodooHDA/releases), which may have reduced audio quality compared to AppleHDA.

#### Installing VoodooHDA

Set `csr-active-config` in your config.plist to `03000000`. Then, copy VoodooHDA.kext to `/Library/Extensions` and VoodooHDA.prefpane to `$HOME/Library/PreferencePanes` using `cp -R` in Terminal. Make sure that VoodooHDA is allowed to load in System Settings < Security.

### Supported SMBIOS

* MacBook Pro 16-inch (2019)
* Mac Pro (2019)
* MacBook Pro 13-inch, Four Thunderbolt 3 Ports (2020)
* iMac (2020)

[Click here](./smbios-support.md) for more details on supported SMBIOS models to pick the best one for your machine.

### Broadcom WiFi

As Broadcom support has been removed since macOS Sonoma, root patches were required to bring it back. However, [AppleBCMWLANCompanion](https://github.com/0xFireWolf/AppleBCMWLANCompanion) brings back support for macOS 15 and 26 without needing root patching. It is not fully stable nor feature-complete yet, so use it at your own discretion. A support thread is available [here](https://www.insanelymac.com/forum/topic/361710-broadcom-fullmac-wi-fi-support-on-macos-sonoma-sequoia-and-tahoe-without-root-patches/).

Note that VT-d must be enabled to use this kext.

### Intel Bluetooth

On macOS 26, use the `-ibtcompatbeta` boot argument to use Intel Bluetooth.

### OTA Updates

On macOS 14.4 and above, OTA updates are only possible by using [RestrictEvents](https://github.com/acidanthera/RestrictEvents/releases) along with the boot argument `revpatch=sbvmm`. Additionally, `SecureBootModel` must be set to `Disabled` in your config.plist. If you want to keep secure boot enabled, add [iBridged](https://github.com/Carnations-Botanica/iBridged) to your kexts.

### WhateverGreen

WhateverGreen has AMD connector patching issues on macOS 26. If you have a kernel panic related to WhateverGreen or AMD GPU kexts, this is likely your problem. As there is no workaround available yet, your only option is to remove WhateverGreen.kext entirely. If you require `agdpmod=pikera` to boot, manually apply this [patch](https://pikeralpha.wordpress.com/2015/11/23/patching-applegraphicsdevicepolicy-kext/) to your configuration. Note that kext patches like this need to go under `Kernel -> Patch` in your config.plist.
2 changes: 1 addition & 1 deletion extras/ventura.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Apple has left a dyld cache that does not use AVX2 instructions in Ventura to su
* Delta updates (small 1-3GB updates) will no longer be available and you must install the full update (12GB), as delta updates only contain the non-AVX2 cache on Apple Silicon machines
* Polaris GPUs remain unsupported on machines without AVX2

Because of these caveats, Dortania will no longer be supporting pre-Haswell CPUs for Ventura and above. The pages for these CPUs will remain updated for Monterey.
Because of these caveats, the Dortania guide will no longer be supporting pre-Haswell CPUs for Ventura and above. The pages for these CPUs will remain updated for Monterey.

### Supported SMBIOS

Expand Down
17 changes: 10 additions & 7 deletions installer-guide/linux-install.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,23 +48,26 @@ python3 ./macrecovery.py -b Mac-BE088AF8C5EB4FA2 -m 00000000000J80300 download
python3 ./macrecovery.py -b Mac-7BA5B2DFE22DDD8C -m 00000000000KXPG00 download

# Catalina (10.15)
python3 ./macrecovery.py -b Mac-CFF7D910A743CAAF -m 00000000000PHCD00 download
python3 ./macrecovery.py -b Mac-00BE6ED71E35EB86 -m 00000000000000000 download

# Big Sur (11)
python3 ./macrecovery.py -b Mac-42FD25EABCABB274 -m 00000000000000000 download
python3 ./macrecovery.py -b Mac-2BD1B31983FE1663 -m 00000000000000000 download

# Monterey (12)
python3 ./macrecovery.py -b Mac-FFE5EF870D7BA81A -m 00000000000000000 download
python3 ./macrecovery.py -b Mac-E43C1C25D4880AD6 -m 00000000000000000 download

# Ventura (13)
python3 ./macrecovery.py -b Mac-4B682C642B45593E -m 00000000000000000 download
python3 ./macrecovery.py -b Mac-B4831CEBD52A0C4C -m 00000000000000000 download

# Sonoma (14)
python3 ./macrecovery.py -b Mac-226CB3C6A851A671 -m 00000000000000000 download
python3 ./macrecovery.py -b Mac-827FAC58A8FDFA22 -m 00000000000000000 download

# Latest version
# ie. Sequoia (15)
python3 ./macrecovery.py -b Mac-937A206F2EE63C01 -m 00000000000000000 download
# Sequoia (15)
python3 ./macrecovery.py -b Mac-7BA5B2D9E42DDD94 -m 00000000000000000 download

# Latest (Tahoe, 26)
python3 ./macrecovery.py -b Mac-CFF7D910A743CAAF -m 00000000000000000 -os latest download
```

From here, run one of those commands in terminal and once finished you'll get an output similar to this:
Expand Down
17 changes: 10 additions & 7 deletions installer-guide/mac-install-recovery.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,23 +36,26 @@ python3 ./macrecovery.py -b Mac-BE088AF8C5EB4FA2 -m 00000000000J80300 download
python3 ./macrecovery.py -b Mac-7BA5B2DFE22DDD8C -m 00000000000KXPG00 download

# Catalina (10.15)
python3 ./macrecovery.py -b Mac-CFF7D910A743CAAF -m 00000000000PHCD00 download
python3 ./macrecovery.py -b Mac-00BE6ED71E35EB86 -m 00000000000000000 download

# Big Sur (11)
python3 ./macrecovery.py -b Mac-42FD25EABCABB274 -m 00000000000000000 download
python3 ./macrecovery.py -b Mac-2BD1B31983FE1663 -m 00000000000000000 download

# Monterey (12)
python3 ./macrecovery.py -b Mac-FFE5EF870D7BA81A -m 00000000000000000 download
python3 ./macrecovery.py -b Mac-E43C1C25D4880AD6 -m 00000000000000000 download

# Ventura (13)
python3 ./macrecovery.py -b Mac-4B682C642B45593E -m 00000000000000000 download
python3 ./macrecovery.py -b Mac-B4831CEBD52A0C4C -m 00000000000000000 download

# Sonoma (14)
python3 ./macrecovery.py -b Mac-226CB3C6A851A671 -m 00000000000000000 download
python3 ./macrecovery.py -b Mac-827FAC58A8FDFA22 -m 00000000000000000 download

# Latest version
# ie. Sequoia (15)
python3 ./macrecovery.py -b Mac-937A206F2EE63C01 -m 00000000000000000 download
# Sequoia (15)
python3 ./macrecovery.py -b Mac-7BA5B2D9E42DDD94 -m 00000000000000000 download

# Latest (Tahoe, 26)
python3 ./macrecovery.py -b Mac-CFF7D910A743CAAF -m 00000000000000000 -os latest 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.
Expand Down
2 changes: 1 addition & 1 deletion installer-guide/mac-install.md
Original file line number Diff line number Diff line change
Expand Up @@ -216,4 +216,4 @@ You'll notice that once we open the EFI partition, it's empty. This is where the

![Empty EFI partition](../images/installer-guide/mac-install-md/base-efi.png)

## Now with all of this done, head to [Setting up the EFI](./opencore-efi.md) to finish up your work
Now with all of this done, head to [Setting up the EFI](./opencore-efi.md) to finish up your work
Loading