A concise, beginner-friendly guide to install Omarchy Mac Fedora on Fedora Asahi Remix (aarch64) for Apple Silicon Macs M1/M2
This project is an extension of Omarchy Mac project.
Important: Fedora Asahi Minimal first boot lands in a TTY setup flow. You must complete all prompts there before running Omarchy Mac Fedora installer steps.
- Fedora Asahi device support: https://asahilinux.org/fedora/#device-support
- Omarchy Mac Fedora Discord: https://discord.gg/jdqjcPxxJe
- External monitor discussion: https://github.com/malik-na/omarchy-mac-fedora/discussions/73
- Support the project: https://buymeacoffee.com/malik2015no
Requirements:
- Apple Silicon Mac (M1/M2 family)
- Fedora Asahi Remix Minimal (aarch64)
- A regular user with sudo access
- Internet connectivity
gitinstalled
Unsupported targets:
- Arch/Asahi Alarm runtime paths
- Non-Asahi Fedora installs
- x86_64
Checklist:
- Backup completed
- Fedora Asahi device compatibility checked
- Fedora Asahi first-boot TTY setup completed (language, hostname, time, root password, user, wheel)
- Internet connected
- Sudo user ready
Use one of these methods from your Fedora Asahi session before running the installer.
# Check network devices
nmcli device status
# Connect to a network
nmcli device wifi connect "SSID_NAME" password "PASSWORD"iwctl
# inside iwctl:
# device list
# station wlan0 scan
# station wlan0 get-networks
# station wlan0 connect "SSID_NAME"
# exitIf wlan0 does not exist on your system, replace it with your detected wireless interface name.
Fedora Asahi Minimal normally includes the required first-boot setup prompts; use these commands only to ensure networking is ready before install.
Fedora Asahi Minimal always starts with a TTY setup flow. Complete all prompts there before continuing:
- language
- hostname
- date/time
- root password
- regular user creation
- wheel/sudo access
Do not continue to Omarchy install until all first-boot setup actions are complete.
Optional: improve TTY readability
sudo dnf install -y terminus-fonts-console || sudo dnf install -y terminus-fonts
sudo setfont ter-v22nAs your regular sudo user:
sudo dnf update
git clone https://github.com/malik-na/omarchy-mac-fedora.git ~/.local/share/omarchy
cd ~/.local/share/omarchy
bash install.sh- Reboot and log into your Hyprland session.
- Press
Cmd + Kto learn all the Keybindings. - Validate core desktop behavior: app launcher opens, terminal keybind works, Wi-Fi/Bluetooth menus open, and lock screen works.
The installer currently supports Fedora Asahi Remix on aarch64 only. Verify distro/architecture and rerun.
Run this to confirm Omarchy commands resolve in your login shell:
bash -lc 'echo "$PATH"'
bash -lc 'command -v omarchy-menu omarchy-cmd-terminal-cwd uwsm-app'For implementation and runtime hardening details, see FEDORA_ASAHI_PORTING_PLAN.md.
Menu > Update > Omarchyupdates both the Omarchy repository and Fedora system packages (dnf upgrade --refresh).- Waybar update indicators track git divergence from your configured upstream branch.
Check branch/upstream state:
git -C ~/.local/share/omarchy status -sbNeed help or want to share your setup?
- Discord: https://discord.gg/jdqjcPxxJe
- Support the project:
- Fedora Asahi device support: https://asahilinux.org/fedora/#device-support
- Asahi Linux project: https://asahilinux.org/
- External monitor discussion: https://github.com/malik-na/omarchy-mac-fedora/discussions/73
Thanks to the Asahi Linux community for making Linux by possible on Macs and thanks to DHH for Omarchy.
If this project helped you, please star the repository and share feedback on X by tagging @tiredkebab.