- TypeScript 55.4%
- Nix 33.8%
- Rust 9.9%
- Just 0.9%
| .cargo | ||
| nixos/modules/system/boot/loader/bread | ||
| packages | ||
| src | ||
| vm | ||
| .envrc | ||
| .gitignore | ||
| Cargo.lock | ||
| Cargo.toml | ||
| flake.lock | ||
| flake.nix | ||
| justfile | ||
| LICENSE | ||
| README.md | ||
| rust-toolchain.toml | ||
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.