tailwags/bread
1
0
Fork 0
mirror of https://github.com/tailwags/bread.git synced 2026-02-19 18:09:01 +00:00
Code Issues Projects Releases Packages Wiki Activity
🍞 A modern UEFI bootloader for the linux kernel
55 commits 1 branch 0 tags 150 KiB
  • Rust 70.2%
  • Shell 19.9%
  • Just 9.9%
Find a file
Exact
Matilde Morrone 7306998f09
 Update dependencies
2025-10-27 12:45:52 +01:00
.cargo Disable location details 2024-12-22 18:13:20 +01:00
scripts Use the new pflash firmware for qemu 2024-12-22 18:37:10 +01:00
src Update to edition 2024 2025-03-23 21:11:59 +01:00
.gitignore Use the new pflash firmware for qemu 2024-12-22 18:37:10 +01:00
Cargo.lock Update dependencies 2025-10-27 12:45:52 +01:00
Cargo.toml Update dependencies 2025-10-27 12:45:52 +01:00
justfile Add riscv script 2024-08-13 11:37:04 +02:00
LICENSE Update license 2024-06-11 15:57:46 +02:00
README.md Remove effie from readme 2024-08-19 12:53:43 +02:00
rust-toolchain.toml Update toolchain 2025-10-27 12:45:17 +01:00

README.md

Bread

An experimental UEFI bootloader for the Linux kernel written in Rust.

Unlike other UEFI-only bootloaders, Bread does not use the kernel UEFI-stub. Instead, it relies on the same boot protocol that has been used in traditional BIOS booting for years. This allows for greater control over the memory map and enables more advanced boot scenarios, such as secure boot and encryption, without requiring special support from the kernel.

Currently, the following architectures are supported:

  • x86-64
  • aarch64

In the future, riscv64gc will also be a target, but currently, there are no actual UEFI riscv boards available.

Building

Before building Bread, there are a few prerequisites:

  • just must be installed and available in the PATH.
  • Rust must be installed via rustup. Distro-provided rust versions will not work.
  • QEMU can be optionally installed to run the bootloader in a VM.

To build Bread, simply run just in the terminal. You can then copy the resulting bread.efi file to your EFI partition.

To run inside a vm, ensure QEMU is available in the PATH, then run:

just qemu-x86_64 # or qemu-aarch64

This will create a new ESP folder containing the required files and launch QEMU using the scripts located in the scripts folder.

Configuring

TODO

License

This project is licensed under the APACHE-2.0 LICENSE. You can find more info in the LICENSE file.