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.
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 | bash
The installer is interactive and offers a choice of different Ubuntu releases and build configurations.
Currently supported are:
- Ubuntu Desktop 24.04
- Ubuntu Server 24.04
- Ubuntu Desktop 23.10
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.
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.
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.
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.
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".
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.
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.