1
0
mirror of https://github.com/NixOS/nixos-hardware synced 2024-06-02 02:53:34 +02:00
nixos-hardware/apple/t2/README.md

1.6 KiB

NixOS on T2 Macs

This is the nixos-hardware module of the T2 Linux Project.

Overall, most features (WiFi, bluetooth, audio, touchbar, ...) of Macs are supported, see this page for a detailed list of things that work and things that don't/partially work.

Following this guide is the recommended way to install, as it incudes the extra things you have to do on a T2 Mac.

You can consult the wiki for information specific to T2 Macs.

Unlocking Internal iGPU

The apple-set-os-loader-installer.nix module serves as an installer for the apple-set-os-loader. This tool is designed to unlock the internal integrated GPU (iGPU) on certain MacBooks. See https://wiki.t2linux.org/guides/hybrid-graphics/ for more details.

What it Does:

Upon activation, this module performs the following:

  • Renames the existing BOOTX64.EFI file to bootx64_original.efi.
  • Installs the apple-set-os-loader hook in its place as bootx64.efi.
  • Before the system boots the hook unlocks the iGPU and subsequently calls the original bootx64_original.efi.

How to Implement:

  1. Integrate the apple-set-os-loader installer into your configuration.nix:
imports = [
  ...
  "${builtins.fetchGit { url = "https://github.com/NixOS/nixos-hardware.git"; }}/apple/t2/apple-set-os-loader-installer.nix"
];
  1. Rebuild your system:
sudo nixos-rebuild switch

Note: Always ensure compatibility and make backups of your data before making any system changes.