Skip to content

uki.md

Latest commit

 

History

History
51 lines (38 loc) · 1.63 KB

uki.md

File metadata and controls

51 lines (38 loc) · 1.63 KB

Unified Kernel Images

Have a look at the Arch Documentation - Unified Kernel Images.

FeOS uses objcopy to build UKIs instead of ukify to avoid overlapping PE sections that can cause boot failures. The UKI creation process dynamically calculates section offsets to ensure proper alignment and prevent memory corruption.

Boot from USB Stick

Booting FeOS from USB is quite easy. You just need to prepare a USB stick with a bootable UEFI partition and insert the FeOS UKI.

Warning

The following steps will wipe all data on your USB stick!

  1. Download the latest FeOS UKI *.efi file from the Releases page.

  2. Insert a USB stick into your machine and identify its device address using parted - for this example we assume the USB stick is /dev/sdX

    sudo parted -l
  1. Create a new GPT partition table and an ESP partition:
    sudo parted /dev/sdX --script -- mklabel gpt mkpart primary fat32 1MiB 100% set 1 on
  1. Format the newly created partition with FAT32
    sudo mkfs.fat -F32 /dev/sdX1
  1. Mount the partition
    sudo mount /dev/sdX1 /mnt
  1. Create the EFI directory structure
    sudo mkdir -p /mnt/EFI/BOOT
  1. Copy the FeOS UKI to the EFI partition
    sudo cp feos-*.efi /mnt/EFI/BOOT/BOOTX64.EFI
  1. Optional: copy the secureboot certificate also to the USB stick. You can install it into the UEFI secureboot certificate DB of your machine via the system setup (aka BIOS).
    sudo cp feos.crt /mnt/

Now you have a UEFI bootable USB stick with FeOS.