MX Mac Manual
Welcome to Omarchy MX Mac
Omarchy MX Mac runs Omarchy on Apple Silicon Macs. It keeps Omarchy's desktop, keybindings and update experience, and replaces the parts that Apple hardware needs: a macOS installer instead of an ISO, Arch Linux ARM, the Asahi Linux stack and the Aurora kernel instead of x86 Arch, and a boot chain that lives next to macOS.
It is a community fork of omacom/omarchy. Everything that is not Mac-specific is upstream Omarchy, so the Omarchy manual applies unchanged. This manual covers only what is different on a Mac and how the fork is built.
The fork is feature-frozen: it takes security and boot fixes only. New Apple Silicon work happens on omacom/omarchy-mac quattro-upstream, as set out in the convergence spec. Installed Macs keep updating as before.
Current state
| Omarchy release | 4.0.4 (4.0.4-mac.1), on both channels |
| Installer app | 2.0.10 (opens on Stable at every launch; choose RC from the Release Channel menu) |
| Stable channel | os-v4.0.4-mac.1.20260924-rc, Aurora kernel, Limine boot menu (since 2026-09-24) |
| Release candidate channel | os-v4.0.4-mac.1.20260924-rc, the same image |
| Installed Macs update to | Runtime channel 59 (4.0.4.r7099.gb8ed395-1) and package channel 15, since 2026-09-25 |
| Macs a new install admits | The 22 M1 and M2 models; hardware-qualified on the MacBook Pro 14" M1 Pro (apple,j314s) and 16" M2 Max (apple,j416c) |
Hardware support is what the Asahi Linux project provides, plus what the Aurora kernel adds on top. See Hardware support before installing.
Both channels install the same image today. Macs installed from the earlier Asahi stable image keep the Asahi kernel, and this manual says so where that differs. Work that is decided but not yet in either channel is on Decided, not yet shipped, never stated here as if it shipped.
Where to start
- Install on a Mac: download, verify and run the installer.
- Channels and updates: what
stableandrcmean and how updates arrive. - Architecture: how the three repositories, the signed channels and the installer fit together.
This project is not affiliated with Apple, the Asahi Linux project or the Omarchy Foundation. It is not intended for Parallels, virtual machines or non-Asahi ARM systems.