Skip to content

Introduction

Welcome to the t2linux wiki!

This wiki contains knowledge about running Linux on Macs with the T2 chip. A list of those devices can be found on Apple's website.

Warnings

  • Some kernel versions, notably 5.8.x and 5.9.x are known to have issues. See the releases (those not marked as a pre-release) of aunali1/linux-mbp-arch for ones that have been tested. Keep in mind that some might very have reached their end of life.
  • Ubuntu's GRUB is not booting using the Mac Startup Manager for many users. Thus affected users are advised to install the rEFInd bootloader and boot the kernel using it instead of the Startup Manager.

Getting started

To get started with an installation, refer to the roadmap.

Contact us

You may contact us on the Linux on T2 Macs (2018+) Discord Server, where you can find most of the people involved.

Contribute

Visit the Contribute page for more details.

Notable Resources

Distributions

Different distributions are maintained by different people in their own repositories. If the distribution you want to use has a guide here, it's recommended to follow it instead of the instructions given in one of the repositories or otherwise official documentation by distribution vendor, as it considers T2 support.

Kernel Modules

Support for hardware is cross distro besides patches to the distribution specific kernel. The following repos contain kernel modules for said support:

Guides and similar

Note that, if you are using one of the distributions listed above, you should follow their install guides rather than the ones listed under this section. However, they might still be important to gain a better general picture or to help with specific issues.

Outdated

Notable Contributors

Check out the list of all Notable Contributors here.