Home

We are just getting started.

Questions? Please check out the FAQ first!

If you are a developer or interested in hardware/software documentation, check out the sidebar for places to start.

Asahi Linux is work in progress. Many hardware components are not yet supported! Check out the Feature Support page first. If you still want to give it a go, see the blog post for the initial installer and following updates adding support for more devices and hardware:

• The first Asahi Linux Alpha Release is here!
• M2 is here! July 2022 Release & Progress Report
• Updates galore! November 2022 Progress Report
• Apple GPU drivers now in Asahi Linux
• Paving the Road to Vulkan on Asahi Linux
• OpenGL 3.1 on Asahi Linux
• Our new flagship distro: Fedora Asahi Remix
• New in Fedora Asahi Remix

Pages

• "When will Asahi Linux be done?"
• Apple Platform Security Crash Course
• Apple Silicon Subsystems
• Broken Software
• Codenames
• Devices
• Differences with other platforms
• Distro:Boot process guide
• Distro:Differences from Arch Linux ARM
• FAQ
• Feature Support
• FW:ADT
• Glossary
• HW: Clocks
• HW: SPRR and GXF
• HW:AGX
• HW:AIC
• HW:ANE
• HW:AOP
• HW:APCIe
• HW:Apple Instructions
• HW:ARM System Registers
• HW:ARM System Registers Dumps
• HW:ASC
• HW:AVD
• HW:CPU debug registers
• HW:Debug USB
• HW:GPIO
• HW:MacBook Pro keyboard backlight (FPWM0)
• HW:Memory map
• HW:SEP
• HW:SMC
• HW:SMP spin up
• HW:USB PD
• HW:WDT
• Installing Gentoo with LiveCD
• Introduction to Apple Silicon
• Kernel config notes for distros
• Low level serial debug
• M1 Series Feature Support
• M1 vs. PC Boot
• m1n1:Developer Guide
• m1n1:User Guide
• M2 Series Feature Support
• M3 Series Feature Support
• macOS Sonoma Boot Failures
• Open OS Ecosystem on Apple Silicon Macs
• Partitioning cheatsheet
• perf on M1 systems
• Project:References
• RE:Kernelcache
• Reference Asahi kernel config
• Software known to have issues with 16k page size
• SW:AGX driver notes
• SW:Alternative Distros
• SW:Boot
• SW:DT bindings
• SW:Getting started
• SW:Hypervisor
• SW:Keyboard Layouts
• SW:MachO Boot Protocol
• SW:NVRAM
• SW:Speakers
• SW:Speakers Test Cases
• SW:Storage
• SW:Ubuntu Asahi Gambas
• SW:Ubuntu Asahi Godot
• SW:Ubuntu Asahi Mesa
• SW:Ubuntu Asahi Qemu
• Tethered Boot Setup (For Developers)
• Tethered boot setup on macOS
• Trivia
• U Boot
• Undoing early speaker support hacks
• Yaks in need of shaving