Native Ubuntu installations for Apple silicon hardware
Ubuntu for Apple Silicon
This repository contains scripts to build native Ubuntu images for Apple silicon hardware such as the Apple M1 and M2.
Most of our code has moved to packages nowadays which are available under our Ubuntu Asahi launchpad team. The scripts in this repository can be used to start launchpad livefs builds from our Ubuntu Asahi PPA and convert their output into a zip archive suitable for the Asahi Installer.
Hosted Installer
If you are interested in running Ubuntu Asahi on your machine, here is how you can install one of our pre-built images. In your macos terminal run:
curl -sL https://ubuntuasahi.org/install > install.sh # Download
less install.sh # Review
sh install.sh # Run
or if you like to live dangerously:
curl -sL https://ubuntuasahi.org/install | sh
The installer is interactive and offers a choice of different Ubuntu releases and build configurations.
Currently supported are:
- Ubuntu Desktop 25.10
- Ubuntu Desktop 25.04
- Ubuntu Desktop/Server 24.04
Build from launchpad
Install build requirements:
apt install arch-install-scripts icnsutils
To build the asahi-installer zip archive run:
sudo ./build.sh $BUILD_ID
where BUILD_ID is the ID of a finished launchpad livefs build where the build
products are still available.
FAQ
Can I dual-boot macOS and Linux?
Yes! The installer can automatically resize your macos partition according to your liking and install Ubuntu in the freed up space. Removing macos is not even supported at the moment since it is required to update the system firmware.
Does Ubuntu Asahi support the same features/hardware as Fedora Asahi?
We try to quickly adapt features added by the reference Asahi distribution. Since we always wait for an official release first, it might take us a few weeks longer to roll out support for new hardware but we generally aim for feature parity.
What do I need to do to enable graphics acceleration/sound/webcam?
No additional steps are necessary, it should all work out of the box. In the past there was an "linux-asahi-edge" kernel providing additional features, nowadays everything is included by default.
How can I boot macos or change the default boot entry?
Hold the power button on boot until you see "Loading startup options". You can
now choose which system you want to boot. You can change the default boot entry
by holding the Option key and selecting "Always Use".
How can I remove Ubuntu Asahi?
There is no automated uninstaller, but you can uninstall Ubuntu Asahi by booting into macos, removing all Ubuntu partitions and then resizing the macos APFS container to the full size. A detailed guide is provided in the Asahi Linux Wiki.
More questions?
Join us on IRC or Matrix!
#ubuntu-asahi on OFTC or #_oftc_#ubuntu-asahi:matrix.org.
For more infos you can also check our website ubuntuasahi.org and follow us on Mastodon at @ubuntuasahi@treehouse.systems.