# Asahi Linux

Asahi Linux is a project that ports the Linux kernel and related software to Apple Silicon-powered Macs, started by Hector Martin. It does so by reverse-engineering the SoCs which lack documentation from Apple.

## History

Shortly after Apple announced their transition away from Intel x86 processors in late 2020, Linux creator Linus Torvalds expressed interest in Linux support for the Apple M1 Mac, but thought that the work to make this happen was too time-consuming for him to personally take on the necessary software development tasks.
Martin announced the project in December 2020 and formally started work a month later in 2021, after securing crowd-sourced funding. Alyssa Rosenzweig, who developed the open-source graphics driver stack Panfrost, joined the project to help support the Apple silicon graphics processing unit (GPU). The project has been made challenging by the lack of publicly available documentation of Apple's proprietary firmware.
The developers quickly realized that just attempting to boot the Linux kernel compiled for Apple silicon's processor architecture (AArch64) would be challenging, as it involved working out the functionality of proprietary Apple code used in the boot process. The work was time-consuming and took most of the year, including submitting pull requests to the main Linux kernel developers to keep development in sync and avoid regressions. However, it subsequently led to a thorough and comprehensive explanation of the previously undocumented boot process, which Martin and others published on GitHub.
The project released an experimental alpha version of the Asahi Linux installer in March 2022. The installer offered the choice of a desktop based on Arch Linux ARM, a minimal environment, or a basic UEFI environment for installing OpenBSD or alternate Linux distributions with support for Apple silicon via a bootable USB drive. Despite being able to launch a UEFI shell, booting Microsoft Windows is not supported, and there are no plans to do so, as it would involve modifying the proprietary Windows kernel. While other projects that are attempting to study a possible port of Windows to these systems specified challenging roadblocks related to Windows handling the proprietary Apple Interrupt Controller (AIC), and the 16K pages only found on the IOMMU.
Full support for all Apple silicon-supported Macs is not expected for another year or two following the first alpha release. In July 2022, the Asahi Linux team released an update with support for the M1 Ultra, Mac Studio, and early initial support for the M2 MacBook Pro.
In August 2023, it was announced that Asahi was partnering with the Fedora Project to release the Fedora Asahi Remix, which would supersede the original Arch-based distribution as Asahi's flagship OS. The effort began in late 2021, and is an upstream-first project. The end goal of the project is to merge upstream all changes so that the project's distribution becomes unnecessary.
In October 2023, Fedora Asahi Remix was released as a Beta, then 3 months later, as a stable.
In February 2025, Hector Martin, founder and lead developer of Asahi Linux, announced his resignation from leading the project, citing burnout and difficulties with the Linux kernel community, although the project is expected to continue without him.

## Hardware and driver support

A Vulkan driver is in a working prototype and OpenGL 4.6 and OpenGL ES 3.2 are supported. This driver is currently the only fully-compliant AGX (Apple Silicon GPU) driver for any widespread graphics standard. While initially using the Panfrost driver implementation, the Asahi Linux Project also made use of Gallium-3D and Rust for Linux based APIs for driver development. OpenCL is supported. KDE Plasma rendering is hardware accelerated, while video decoding is not.
HDMI video output is only supported on the Apple silicon Mac mini, and there is no support for video via Thunderbolt although external displays can be used via DisplayLink docks.
The operating system's kernel has been configured for and only supports 16 kB (for reason of performance) pages. Programs that do not (e.g. expect 4 kB or 64 kB pages) experience alignment problems when being mapped to memory. The page sizes set by Linux are global (there is no support for multiple page sizes in operation). The Apple GPU driver supports 4 kB and 16 kB pages.

## Reception

The project has been well received. A review in The Register said that it ran surprisingly well for alpha software that is still in development. Similarly, a review in Ars Technica was impressed by the amount of hardware that was already supported early in the project lifecycle.