Installation Guide

Welcome to the Kryptonite installation guide. Please read this guide in full and carefully before actually beginning the process.

Disclaimer

As with most open source software hacks, you use this software at your own risk. Kryptonite uses OpenCore to inject patches via EFI. Please keep in mind that while these packages are tested extensively, there is always an extremely small chance something could go wrong and brick your device.

Step 1: Review Compatibility

Ensure that your system supports eGPUs and Kryptonite: https://github.com/mayankk2308/kryptonite/wiki/Compatibility

Step 2: Initial Preparations

1. Always keep a backup of all your data.
2. See the Preparing Your System page for next steps.

Step 3: Security Features

If you are using a Mac with T2 chip, set startup security to No Security: https://support.apple.com/en-us/HT208198

All other security features can remain enabled. All other Macs can work with all security features enabled.

Step 4: Prepare OpenCore Volume

If you already have an OpenCore installation, back up your config.plist file. Otherwise, please follow instructions at Create OpenCore Disk.

Step 5: Run Kryptonite Installer

1. Launch Terminal and execute the installer as follows:

   cd ~; curl -qLs https://github.com/mayankk2308/kryptonite/raw/main/Installer/Installer.zip -o Installer.zip; ditto -x -k Installer.zip .; cd Installer; chmod +x installer.sh; ./installer.sh; cd ../; rm -rf Installer*

2. You will be asked if you are already using OpenCore or not. Choose [Y]es if you do, [N]o if not.
3. You will be asked if you want to use DEBUG resources - choose [N]o unless you want to generate logs or are facing issues.
4. You will be asked if you are using an NVIDIA GPU - choose [Y]es if you are using a compatible NVIDIA GPU, otherwise [N]o.
5. Depending on your system, you will be asked if you want to disable your internal GPU to enable display output on your eGPU - choose accordingly.
6. Review you configuration and press [Y]es to proceed with the setup.

Step 6: Prepare System For Boot

1. After the setup process completes, restart your Mac while holding OPTION key.
2. Use arrow keys to select Kryptonite boot disk.
3. Press CTRL + ENTER to set it as default boot disk.
4. You can boot into any of your macOS installations via the OpenCore boot picker.

Step 7: Post-Install

Review Compatibility. For some NVIDIA GPUs, you will require NVIDIA Web Drivers. If your GPU needs it, please install them via Terminal as follows:

bash <(curl -s https://raw.githubusercontent.com/Benjamin-Dobell/nvidia-update/master/nvidia-update.sh)

Then reboot your system.

To make further enhancements to your setup, please look at the Post-Install section. This includes information about disabling internal GPUs, skipping the boot picker on every boot to directly boot into macOS, additional configuration for Bootcamp users to combat error 12, and more.

If you need to uninstall, please follow the Uninstallation steps.