Skip to content

add firmware update steps #192

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open

add firmware update steps #192

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
1f0d454
add firmware update steps
joske May 14, 2025
930c1de
add warning
joske May 14, 2025
9f6cc72
add link to partitioning cheatsheet
joske May 14, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 31 additions & 0 deletions docs/fw/fw-update.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# Firmware update

These steps allow you to upgrade the firmware in the macOS stub partition. These are manual steps, and the risk of messing up is high.

```
Please ensure you have a restorable backup of your Fedora installation.
Please attempt this only if you’re comfortable with the steps mentioned here and be prepared to do a fresh install.
```

Make sure to read and understand how macOS partitions work in the [partitioning cheatsheet](https://github.com/AsahiLinux/docs/wiki/Partitioning-cheatsheet).

- boot into Linux
- edit /etc/fstab and comment out the line with /boot/efi
- reboot into macOS
- mount the EFI partition of your linux install with `diskutil mount 'EFI - LINUX'` or similar (check the correct name with `diskutil list`)
- copy the contents of this partition (using finder or cp) somewhere in macOS
- unmount the partition again with `diskutil umount 'EFI - LINUX'`
- wipe the APFS container (2.5 GB) using `diskutil apfs deleteContainer disk0s3` !! double and triple check the device id !!
- wipe the EFI partition (500MB) using `diskutil eraseVolume free free disk0s4`
- you should now have 3 GB free between the macOS APFS container and the 'Linux Filesystem' with your rootfs
- start the asahi installer and choose the option 'UEFI environment only'
- the installer will ask to shutdown and reboot into the recovery of the stub partition
- follow the steps inside recovery until the point it asks to reboot, **don't reboot**, but press Ctrl-C to exit the script
- go to the Apple logo in the top left corner and choose 'Startup Disk'
- set your macOS disk as startup disk and reboot into macOS
- mount the EFI partition again using `diskutil mount` (note that the name may be different from above if you chose a different name for the UEFI install)
- copy the `EFI` and `m1n1` folders from your backup over the new EFI partition
- reboot into Linux by setting the Startup Disk back to Linux or by holding the power button at boot
- check the UUID of the EFI partition with `lsblk -f`. Look for the one which is short (XXXX-XXXX)
- edit `/etc/fstab`, uncomment the /boot/efi line and replace the UUID with the new one
- reboot again and you should now be on latest firmware and back where you were