How to Install Asahi Linux on Your M1 Mac

Asahi Featured Image

While M1 Macs are great, they cannot run a Linux distro natively until recently. Asahi Linux, an Arch-based distro, is the first Linux distro specially made for M1 machines, and you can run it natively on Macs with the M1, M1 Pro, and M1 Max chips. Moreover, you can dual boot Asahi Linux to use it without replacing your macOS. In this tutorial, we cover everything, including how to download, install, and even uninstall Asahi Linux.

Before You Start

Asahi Linux is still in its Alpha release. As of now, you can’t run it on Mac Studio. Some of the features, like DisplayPort, GPU acceleration, and Touch Bar (for 13” MacBook Pro), don’t work yet.

You can get the complete list of “What doesn’t” work on the official announcement page. Although, in my usage, I found that Bluetooth works just fine, but the official announcement page said it is not working.

Asahi1 2

Installing Asahi Linux

Asahi Linux has a self-explanatory installer. As long as you understand and answer the on-screen prompts, you are good to go.

Note: make sure to keep a backup of your important data before starting the installation process.

  1. To install Asahi Linux, open the terminal on your macOS and run:
curl | sh

This will download and execute the shell script to install Asahi Linux.

Asahi Curl
  1. Enter your sudo password when prompted. (Your sudo password is your Mac’s user password.) The terminal will prompt you to make sure that you have read the documentation. Press Enter to continue.
  2. A prompt will ask you if you want to enable expert mode or not. You can choose either one. In my case, I am pressing N and Enter to continue with the normal mode. This will show you your username and the basic information about the partitions.
Asahi Expert Mode

Resizing Your macOS Partition

  1. When it asks you to “Choose what to do,” press r and Enter to resize your existing partition and make space for the Linux distro.
Asahi First What To Do
  1. A prompt will ask you to set a new size for your macOS. You can use a percentage, storage size, or enter min (which will shrink your macOS to the minimum possible size). For example, you can enter 70% to set your macOS size to 70% of the total space. I am entering “230GB” to make my macOS shrink to 230GB.
Asahi Input Partition Size

You will see how much space you will have freed up after resizing. Press y and Enter to continue and start resizing your partition.

Asahi Continue With The Resize
  1. Press Enter when the resizing is completed.
Asahi Resizing Completed

Installing Asahi Linux on the New Partition

  1. When prompted with “Choose what to do” again, press f and Enter to install the Asahi Linux in the free space.
Asahi Second Choose What To Do
  1. You will see the prompt “Choose an OS to install.” Choose the one that suits you best. I am choosing “1” to install Asahi Linux with all the preinstalled apps. Type your chosen number and press Enter.
  1. You will be prompted with the question “How much space should be allocated to the new OS?” As before, you can enter a storage size or percentage of the free space. Entering min and max will allocate the minimum and maximum possible space for the Linux distro. I am entering “max” to allocate all the free space to Asahi Linux. Enter a name for your OS, press Enter and the script will download and set up everything for you. If it asks for the admin credentials, enter your macOS user password.
Asahi Os Name
  1. When everything is configured, you will be asked to press Enter to read the instructions. Read the instructions carefully, which are crucial for successfully booting into Asahi Linux.
Asahi Read Instructions
  1. Press Enter to shut down your Mac.
Asahi Shutdown
  1. Wait 15 seconds for the system to fully shut down, then press and hold your power button until you see “Entering startup options” or a spinner.
Asahi Spinner
  1. You will see a list of volumes on the startup options. Select the volume with your previously-set OS name and select “Continue.”
Asahi List Of Options 1
  1. This will boot into the macOS Recovery screen. On the recovery screen, select your username, click “Next” and enter your macOS user password to open a terminal window.
Asahi Select User
  1. On the terminal, press Enter to continue the installation process.
Asahi Terminal
  1. You will be asked to enter the password for your username. Use the same username and password if you are prompted again.
Asahi User Password
  1. Press y and Enter if you are asked whether you want to continue.
  1. Press Enter to reboot, then select Arch Linux from the grub menu to boot into Asahi Linux.
Asahi Linux Reboot

Completing Asahi Linux Setup Screen

  1. Once you boot into Asahi Linux, you will see a setup page for Asahi Linux. Set your language, region, time zone, and keyboard layout as you would do with any other Linux distro.
Asahi Welcome Screen
  1. Enter a username, computer name, and password (These can be different from your macOS credentials) and press “Next.”
  1. On the summary screen, press “Set up” to finish the setup. Press “Done” on the Finish screen, which will take you to the login screen.
Asahi Login
  1. Use your previously-set password to log in.

Installing Packages on Asahi Linux

You can use pacman to install any package for arm64 architecture from official Arch Linux repositories. Learn all about pacman here.

For example, to install node.js, run:

sudo pacman -S nodejs npm

and press Y and Enter to confirm.

Asahi2 1

You can also build a package from the source and install it if you want to.

Using macOS and Asahi Linux Together

Asahi Linux is made to run alongside your macOS. However, when you turn your Mac on, it will boot by default into Asahi Linux. To boot into macOS, press and hold your power button until you see “Entering startup options” or a spinner, then select Macintosh HD and press “Continue.”

Asahi Boot Into Mac Os

Uninstalling Asahi Linux

You can uninstall Asahi Linux by deleting the partitions for Asahi Linux.

  1. Run diskutil list in your macOS terminal and copy the volume identifier from the line with “EFI” and your Linux OS’s name in it.
Asahi1 1

In my case, the line is “EFI EFI – MINIX,” and the identifier is “disk0s4.”

  1. To delete the volume, run:
diskutil eraseVolume JHFS+ drive /drive/YourDiskIdentifier

Make sure to replace “YourDiskIdentifier” with the actual disk identifier.

Asahi2 2
  1. Now open the Disk Utility app. Select “Partition” from the top border and delete the first three consecutive partitions at the end of your Macintosh HD partition.
Asahi Partitions

To delete a partition, select the partition and press the “–” button. Make sure to delete the correct partitions. The first partition’s name will be your Linux OS’s name. The second partition is named “drive,” which is around 500MB. The third partition is the partition for Asahi Linux’s home directory, which will display the home directory’s size of Asahi Linux. (It will be closer to the size of your total allocated storage for Asahi Linux.)

Asahi Marked

Click “Apply” to apply the changes you just made to your partitions.

Asahi After Deleting

This will open a new window with the partition names you are going to delete. Select “Partition.”

Asahi Partition Delete

It will take some time, and your Mac may temporarily appear to be frozen, which is totally normal.

Asahi Applying

Select “Done” when the process completes.

Asahi Done

Fixing the Boot Screen

  1. Now that you are done with Disk Utility, restart your Mac. On the boot screen, you will see a “Custom kernel failed to boot” warning.
  2. Select “Startup disk.”
Asahi Custom Kernel
  1. On the next screen, select “Macintosh HD” and click “Restart.”
Asahi Sure Restart

Your Mac will continue to start as usual.

Frequently Asked Questions

Do I need a USB drive to install Asahi Linux?

No. You can complete the installation process without using any external USB drive.

Can I install x86 architecture-based packages on Asahi Linux?

No. Asahi Linux is an Arm architecture-based distro, and you can only install packages that have a build for Arm.

Can dual-booting macOS and Asahi Linux slow down my macOS?

No. Your Mac will run and allocate resources like CPU and memory for one operating system at a time, so there shouldn’t be a performance drop on macOS.

Muhammad Munna
Muhammad Munna

Muhammad Munna is an Electrical Engineering student who is passionate about technology and writing. He loves to experiment with different techs and dig deep into them. In his free time, he can be found fiddling with his smartphone camera.

Subscribe to our newsletter!

Our latest tutorials delivered straight to your inbox