Kext Installation & Management

Kernel extensions (kexts) are the macOS equivalent of drivers. This guide covers how to properly install and manage them.

Understanding Kexts

A kext is a bundle (.kext) that contains code loaded into the macOS kernel to provide hardware support or system modifications.

Installation Methods

Method 1: OpenCore (Recommended)

The modern approach is to place kexts in your EFI partition:

1. Copy the .kext to EFI/OC/Kexts/
2. Add an entry in config.plist under Kernel > Add
3. Set the correct load order (dependencies first)
4. Reboot

Method 2: /Library/Extensions (Legacy — Not Recommended)

⚠️ Deprecated: This method does not work on macOS 11 Big Sur and later. Apple has removed support for third-party kexts in /Library/Extensions/. Use the OpenCore method above instead.

For older macOS versions (10.15 Catalina and below) or specific use cases:

1. Copy the .kext to /Library/Extensions/
2. Fix permissions: sudo chmod -R 755 /Library/Extensions/YourKext.kext
3. Rebuild kext cache: sudo kextcache -i /
4. Reboot

Load Order Matters

Kexts must be loaded in the correct order. Dependencies must come before the kexts that need them:

1. Lilu (always first - required by many plugins)
2. VirtualSMC or FakeSMC
3. WhateverGreen (GPU)
4. AppleALC (Audio)
5. Other kexts…

Troubleshooting

Kext not loading

• Check config.plist entry is correct
• Verify BundlePath, ExecutablePath, and PlistPath
• Ensure dependencies are loaded first

Kernel panic on boot

• Remove recently added kexts one at a time
• Check kext compatibility with your macOS version
• Verify you’re using the latest version

Using OCAT for easier management

OpenCore Auxiliary Tools (OCAT) provides a graphical interface for managing your config.plist and kexts. It can automatically add kext entries and set the correct load order.

Related Kexts

• Lilu - Required by most plugin kexts
• VirtualSMC - SMC emulation