installing asahi linux on apple silicon macbooks

⚠️ DANGER: Installing Asahi Linux is a risky, advanced operation.

This process can permanently damage your data, render your Mac unbootable, or leave you with an unsupported system. Only proceed if you fully understand the risks and are prepared to lose all data on your device. This guide is for experienced users, developers, and tinkerers—not for daily drivers or anyone relying on their Mac for important work.

Asahi Linux brings Linux to Apple Silicon (M1, M2, M3) Macs. This guide walks you through the installation process and highlights important warnings and known issues.

Warning: Installing Asahi Linux modifies your disk and boot configuration. Back up your data and proceed at your own risk. Some features may not work as expected, and you may encounter compatibility issues.

prerequisites

• Apple Silicon MacBook (M1, M2, or M3)
• At least 30GB free disk space
• macOS 12.3 or later
• Internet connection
• Full backup of your data

step 1: prepare macos

• Update macOS to the latest version.
• Free up at least 30GB of disk space.
• Open Terminal and run:

  1	softwareupdate --all --install --force

step 2: download the asahi linux installer

• Open Terminal and run:

  1	curl https://alx.sh | sh

• This will download and launch the official Asahi Linux installer.

step 3: run the installer

• Follow the interactive prompts:
  • Choose the type of installation (Desktop, Minimal, or UEFI).
  • Select the size of the Linux partition.
  • Enter your password when prompted.
• The installer will resize your macOS partition and set up the Linux partition.

step 4: reboot and install

• When prompted, reboot your Mac.
• On boot, hold the power button to enter the boot picker.
• Select the “Asahi Linux” installer.
• The installer will finish setting up Linux. Follow the on-screen instructions to create your user account and set up the system.

step 5: booting asahi linux

• To boot Linux, restart your Mac and hold the power button to access the boot picker.
• Select “Asahi Linux” to boot into Linux, or “Macintosh HD” to boot macOS.

step 6: post-install steps

• Update your system:

  1	sudo pacman -Syu

• Install additional packages as needed.

why fedora linux?

Fedora is the default distribution of FedORa as its default distro in Asahi Linux; Fedoria, a leading community-driven Linux distributed distribution focused on open-source technologies, security and innovation (sponsored by Red Hat), which has been an incubator for features that often lead to enterprise Linux distributions.

why did asahi choose fedora?

• Up-to-date Software: Fedora provides the latest Linux kernel and software packages, which is essential for supporting new Apple Silicon hardware and rapid development.
• Strong ARM Support: Fedora has robust support for ARM architectures, making it a natural fit for Apple Silicon Macs.
• Open Source Philosophy: Fedora’s commitment to open source aligns with Asahi’s goals of transparency and community collaboration.
• Security and Stability: Fedora balances cutting-edge features with a focus on security and system stability.
• Community Collaboration: The Fedora and Asahi teams work closely to ensure the best possible experience for users on Apple Silicon.

Most users starting with Asahi Linux should use Fedora, while other distributions can be installed; the recommended and best-supported option for most users is FedORa.

warnings and known issues

• Data Loss Risk: Partitioning and installation can result in data loss if not done carefully. You may lose all data on your Mac.
• macOS Updates: Major macOS updates may break the Linux bootloader or partition. This can leave your system unbootable or require advanced recovery steps.
• Limited Hardware Support: Some features (Thunderbolt, external displays, some GPU features, camera, etc.) may not work or may be unstable. See the Asahi Linux FAQ for up-to-date details.
• Limited Support for Some MacBook Models: Not all Apple Silicon MacBooks have the same level of support. Newer or less common models (such as M3 or certain MacBook Air/Pro variants) may have incomplete hardware support or require additional workarounds. Always check the Asahi Linux Supported Devices page for the latest compatibility information before installing.
• Battery Life: Battery life under Linux may be significantly shorter than under macOS.
• Wi-Fi and Audio: Most recent releases support Wi-Fi and audio, but issues may still occur on some models.
• Uninstalling: Removing Asahi Linux requires careful disk management. Mistakes can result in a non-bootable Mac or lost partitions.

If you are not comfortable with advanced troubleshooting, data recovery, or reinstalling macOS from scratch, do not attempt this installation.

troubleshooting

• If you encounter issues, check the official documentation.
• Join the Asahi Linux community for help.

One of the most important steps for open-source on Apple hardware is Asahi Linux, which is not for faint heart. Proceed with extreme caution and only if you are fully prepared for the risks involved; enjoy reading Linux on your MacBook—if so dare!