Skip to content

Creates a Fedora usb drive that will boot on Apple M-series systems

License

Notifications You must be signed in to change notification settings

FlameFactory/asahi-fedora-usb

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Creates a Fedora usb drive that will boot on Apple M-series systems

Fedora Package Install

dnf install arch-install-scripts bubblewrap gdisk mkosi pandoc rsync systemd-container

Notes

  • The root password is fedora
  • The qemu-user-static package is needed if building the image on a non-aarch64 system
  • This project is based on mkosi v22 which matches the current version of mkosi in the F40 repo
    https://src.fedoraproject.org/rpms/mkosi/
    However....mkosi is updated so quickly that it's difficult to keep up at times (I have several projects based on mkosi)
    I'll strive to keep things updated to the latest version supported in Fedora
    If needed, you can always install a specific version via pip
    python3 -m pip install --user git+https://github.com/systemd/mkosi.git@v22

To build a minimal Fedora image and install it to a usb drive, simply run:

./build.sh -d /dev/sda

note: substitute /dev/sda with the device id of your usb drive

If you've previously installed this Fedora image to the usb drive, you can wipe the drive and install a new image without having to repartition/reformat the drive by providing the -w argument

./build.sh -wd /dev/sda

Once the drive is created, you can locally mount, unmount, or chroot into the usb drive (which contains 3 partitions) to/from mnt_usb/ with

./build.sh mount
./build.sh umount
./build.sh chroot

note: mounting the usb drive is useful for inspecting the contents of the drive or making changes to it

To boot the usb drive, type bootmenu at the u-boot prompt and select the usb drive

Setting up WiFi

To connect to a wireless network, use the following sytanx: nmcli dev wifi connect network-ssid

An actual example: nmcli dev wifi connect blacknet-ac password supersecretpassword

Rescuing a Fedora install

Two helper scripts have been added to this image
Which are useful if you have Fedora installed on the internal drive:

/usr/local/sbin/chroot.asahi
/usr/local/sbin/umount.asahi
  1. chroot.asahi will mount the (Fedora) internal drive under /mnt and will arch-chroot into it.
    To exit from the chroot environment, simply type ctrl+d or exit

  2. umount.asahi will unmount the internal drive from /mnt

About

Creates a Fedora usb drive that will boot on Apple M-series systems

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 100.0%