mirror of
https://github.com/edera-dev/sprout.git
synced 2025-12-19 22:30:17 +00:00
Compare commits
10 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 2a9c9f6907 | |||
|
16755acdfe
|
|||
| ebb1f0bb44 | |||
|
ecba8a5e02
|
|||
| 0028e3eefc | |||
|
|
8603794c44 | ||
| 4fae4080a2 | |||
|
|
da5e0daa51 | ||
|
0fb54a948b
|
|||
|
c4475ad42d
|
4
.github/workflows/ci-actions.yml
vendored
4
.github/workflows/ci-actions.yml
vendored
@@ -35,7 +35,7 @@ jobs:
|
|||||||
persist-credentials: false
|
persist-credentials: false
|
||||||
|
|
||||||
- name: setup uv
|
- name: setup uv
|
||||||
uses: astral-sh/setup-uv@2ddd2b9cb38ad8efd50337e8ab201519a34c9f24 # v7.1.1
|
uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7.1.2
|
||||||
|
|
||||||
- name: zizmor
|
- name: zizmor
|
||||||
run: uvx zizmor --pedantic --format sarif . > results.sarif
|
run: uvx zizmor --pedantic --format sarif . > results.sarif
|
||||||
@@ -43,7 +43,7 @@ jobs:
|
|||||||
GH_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
|
GH_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
|
||||||
|
|
||||||
- name: upload
|
- name: upload
|
||||||
uses: github/codeql-action/upload-sarif@4e94bd11f71e507f7f87df81788dff88d1dacbfb # v4.31.0
|
uses: github/codeql-action/upload-sarif@0499de31b99561a6d14a36a5f662c2a54f91beee # v4.31.2
|
||||||
with:
|
with:
|
||||||
sarif_file: results.sarif
|
sarif_file: results.sarif
|
||||||
category: zizmor
|
category: zizmor
|
||||||
|
|||||||
4
.github/workflows/codeql.yml
vendored
4
.github/workflows/codeql.yml
vendored
@@ -47,13 +47,13 @@ jobs:
|
|||||||
persist-credentials: false
|
persist-credentials: false
|
||||||
|
|
||||||
- name: initialize codeql
|
- name: initialize codeql
|
||||||
uses: github/codeql-action/init@4e94bd11f71e507f7f87df81788dff88d1dacbfb # v4.31.0
|
uses: github/codeql-action/init@0499de31b99561a6d14a36a5f662c2a54f91beee # v4.31.2
|
||||||
with:
|
with:
|
||||||
languages: ${{ matrix.language }}
|
languages: ${{ matrix.language }}
|
||||||
build-mode: ${{ matrix.build-mode }}
|
build-mode: ${{ matrix.build-mode }}
|
||||||
config-file: ./.github/codeql/codeql-config.yaml
|
config-file: ./.github/codeql/codeql-config.yaml
|
||||||
|
|
||||||
- name: perform codeql analysis
|
- name: perform codeql analysis
|
||||||
uses: github/codeql-action/analyze@4e94bd11f71e507f7f87df81788dff88d1dacbfb # v4.31.0
|
uses: github/codeql-action/analyze@0499de31b99561a6d14a36a5f662c2a54f91beee # v4.31.2
|
||||||
with:
|
with:
|
||||||
category: "/language:${{matrix.language}}"
|
category: "/language:${{matrix.language}}"
|
||||||
|
|||||||
24
Cargo.lock
generated
24
Cargo.lock
generated
@@ -46,9 +46,9 @@ dependencies = [
|
|||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "crypto-common"
|
name = "crypto-common"
|
||||||
version = "0.1.6"
|
version = "0.1.7"
|
||||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
checksum = "1bfb12502f3fc46cca1bb51ac28df9d618d813cdc3d2f25b9fe775a34af26bb3"
|
checksum = "78c8292055d1c1df0cce5d180393dc8cce0abec0a7102adb6c7b1eef6016d60a"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"generic-array",
|
"generic-array",
|
||||||
"typenum",
|
"typenum",
|
||||||
@@ -66,7 +66,7 @@ dependencies = [
|
|||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "edera-sprout-boot"
|
name = "edera-sprout-boot"
|
||||||
version = "0.0.24"
|
version = "0.0.25"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"anyhow",
|
"anyhow",
|
||||||
"edera-sprout-build",
|
"edera-sprout-build",
|
||||||
@@ -82,18 +82,18 @@ dependencies = [
|
|||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "edera-sprout-build"
|
name = "edera-sprout-build"
|
||||||
version = "0.0.24"
|
version = "0.0.25"
|
||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "edera-sprout-config"
|
name = "edera-sprout-config"
|
||||||
version = "0.0.24"
|
version = "0.0.25"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"serde",
|
"serde",
|
||||||
]
|
]
|
||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "edera-sprout-eficore"
|
name = "edera-sprout-eficore"
|
||||||
version = "0.0.24"
|
version = "0.0.25"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"anyhow",
|
"anyhow",
|
||||||
"bitflags",
|
"bitflags",
|
||||||
@@ -106,9 +106,9 @@ dependencies = [
|
|||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "generic-array"
|
name = "generic-array"
|
||||||
version = "0.14.9"
|
version = "0.14.7"
|
||||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
checksum = "4bb6743198531e02858aeaea5398fcc883e71851fcbcb5a2f773e2fb6cb1edf2"
|
checksum = "85649ca51fd72272d7821adaf274ad91c288277713d9c18820d8499a7ff69e9a"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"typenum",
|
"typenum",
|
||||||
"version_check",
|
"version_check",
|
||||||
@@ -172,9 +172,9 @@ dependencies = [
|
|||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "quote"
|
name = "quote"
|
||||||
version = "1.0.41"
|
version = "1.0.42"
|
||||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
checksum = "ce25767e7b499d1b604768e7cde645d14cc8584231ea6b295e9c9eb22c02e1d1"
|
checksum = "a338cc41d27e6cc6dce6cefc13a0729dfbb81c262b1f519331575dd80ef3067f"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"proc-macro2",
|
"proc-macro2",
|
||||||
]
|
]
|
||||||
@@ -252,9 +252,9 @@ dependencies = [
|
|||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "syn"
|
name = "syn"
|
||||||
version = "2.0.108"
|
version = "2.0.110"
|
||||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
checksum = "da58917d35242480a05c2897064da0a80589a2a0476c9a3f2fdc83b53502e917"
|
checksum = "a99801b5bd34ede4cf3fc688c5919368fea4e4814a4664359503e6015b280aea"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"proc-macro2",
|
"proc-macro2",
|
||||||
"quote",
|
"quote",
|
||||||
|
|||||||
@@ -9,7 +9,7 @@ resolver = "3"
|
|||||||
|
|
||||||
[workspace.package]
|
[workspace.package]
|
||||||
license = "Apache-2.0"
|
license = "Apache-2.0"
|
||||||
version = "0.0.24"
|
version = "0.0.25"
|
||||||
homepage = "https://sprout.edera.dev"
|
homepage = "https://sprout.edera.dev"
|
||||||
repository = "https://github.com/edera-dev/sprout"
|
repository = "https://github.com/edera-dev/sprout"
|
||||||
edition = "2024"
|
edition = "2024"
|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
ARG RUST_PROFILE=release
|
ARG RUST_PROFILE=release
|
||||||
ARG RUST_TARGET_SUBDIR=release
|
ARG RUST_TARGET_SUBDIR=release
|
||||||
|
|
||||||
FROM --platform=$BUILDPLATFORM rust:1.91.0-alpine@sha256:a3e3d30122c08c0ed85dcd8867d956f066be23c32ed67a0453bc04ce478ad69b AS build
|
FROM --platform=$BUILDPLATFORM rust:1.91.1-alpine@sha256:fbcca3e30e26f79986809d5dbfcdbeaaf8d3f8a4475b7a19a973363b45c74d97 AS build
|
||||||
RUN apk --no-cache add musl-dev busybox-static
|
RUN apk --no-cache add musl-dev busybox-static
|
||||||
ARG RUST_PROFILE
|
ARG RUST_PROFILE
|
||||||
RUN adduser -S -s /bin/sh build
|
RUN adduser -S -s /bin/sh build
|
||||||
|
|||||||
@@ -47,8 +47,9 @@ We recommend running Sprout without Secure Boot for development, and with Secure
|
|||||||
|
|
||||||
| Operating System | Secure Boot Enabled | Link |
|
| Operating System | Secure Boot Enabled | Link |
|
||||||
|------------------|---------------------|-------------------------------------------------------|
|
|------------------|---------------------|-------------------------------------------------------|
|
||||||
| Ubuntu | ✅ | [Setup Guide](./docs/setup/signed/ubuntu.md) |
|
| Fedora | ✅ | [Setup Guide](./docs/setup/signed/fedora.md) |
|
||||||
| Debian | ✅ | [Setup Guide](./docs/setup/signed/debian.md) |
|
| Debian | ✅ | [Setup Guide](./docs/setup/signed/debian.md) |
|
||||||
|
| Ubuntu | ✅ | [Setup Guide](./docs/setup/signed/ubuntu.md) |
|
||||||
| openSUSE | ✅ | [Setup Guide](./docs/setup/signed/opensuse.md) |
|
| openSUSE | ✅ | [Setup Guide](./docs/setup/signed/opensuse.md) |
|
||||||
| Fedora | ❌ | [Setup Guide](./docs/setup/unsigned/fedora.md) |
|
| Fedora | ❌ | [Setup Guide](./docs/setup/unsigned/fedora.md) |
|
||||||
| Alpine Edge | ❌ | [Setup Guide](./docs/setup/unsigned/alpine-edge.md) |
|
| Alpine Edge | ❌ | [Setup Guide](./docs/setup/unsigned/alpine-edge.md) |
|
||||||
|
|||||||
@@ -385,7 +385,7 @@ fn efi_main() -> Status {
|
|||||||
let result = run();
|
let result = run();
|
||||||
if let Err(ref error) = result {
|
if let Err(ref error) = result {
|
||||||
// Print an error trace.
|
// Print an error trace.
|
||||||
error!("sprout encountered an error:");
|
error!("sprout encountered an error: {}", error);
|
||||||
for (index, stack) in error.chain().enumerate() {
|
for (index, stack) in error.chain().enumerate() {
|
||||||
error!("[{}]: {}", index, stack);
|
error!("[{}]: {}", index, stack);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -60,7 +60,7 @@ Copy the downloaded `sprout.efi` file to `/boot/efi/EFI/sprout/sprout.unsigned.e
|
|||||||
## Step 4: Sign Sprout for Secure Boot
|
## Step 4: Sign Sprout for Secure Boot
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# For x86_64, sign the unsigned Sprout artifact and name it grubaa64.efi which is what the shim will call.
|
# For x86_64, sign the unsigned Sprout artifact and name it grubx64.efi which is what the shim will call.
|
||||||
$ sbsign \
|
$ sbsign \
|
||||||
--key /etc/sprout/secure-boot/mok.key \
|
--key /etc/sprout/secure-boot/mok.key \
|
||||||
--cert /etc/sprout/secure-boot/mok.crt \
|
--cert /etc/sprout/secure-boot/mok.crt \
|
||||||
@@ -120,8 +120,8 @@ path = "\\EFI\\sprout\\ext4.efi"
|
|||||||
|
|
||||||
# global options.
|
# global options.
|
||||||
[options]
|
[options]
|
||||||
# enable autoconfiguration by detecting bls enabled
|
# enable autoconfiguration by detecting installed kernels
|
||||||
# filesystems and generating boot entries for them.
|
# generating boot entries for them.
|
||||||
autoconfigure = true
|
autoconfigure = true
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -130,14 +130,16 @@ If you do not have any drivers, exclude the drivers section entirely.
|
|||||||
|
|
||||||
## Step 7: Configure Sprout Boot Entry
|
## Step 7: Configure Sprout Boot Entry
|
||||||
|
|
||||||
In the following commands, replace /dev/ESP_PARTITION with the actual path to the ESP partition block device.
|
In the following commands, replace /dev/BLOCK_DEVICE with the device that houses your GPT partition table,
|
||||||
|
and PARTITION_NUMBER with the partition number of the EFI System Partition. For example, if your EFI System Partition is
|
||||||
|
`/dev/sda1`, the BLOCK_DEVICE would be `/dev/sda` and the PARTITION_NUMBER would be `1`
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# For x86_64, run this command to add Sprout as the default boot entry.
|
# For x86_64, run this command to add Sprout as the default boot entry.
|
||||||
$ efibootmgr -d /dev/ESP_PARTITION -c -L 'Sprout' -l '\EFI\sprout\shimx64.efi'
|
$ efibootmgr -d /dev/BLOCK_DEVICE -p PARTITION_NUMBER -c -L 'Sprout' -l '\EFI\sprout\shimx64.efi'
|
||||||
|
|
||||||
# For aarch64, run this command to add Sprout as the default boot entry.
|
# For aarch64, run this command to add Sprout as the default boot entry.
|
||||||
$ efibootmgr -d /dev/ESP_PARTITION -c -L 'Sprout' -l '\EFI\sprout\shimaa64.efi'
|
$ efibootmgr -d /dev/BLOCK_DEVICE -p PARTITION_NUMBER -c -L 'Sprout' -l '\EFI\sprout\shimaa64.efi'
|
||||||
```
|
```
|
||||||
|
|
||||||
Reboot your machine and it should boot into Sprout.
|
Reboot your machine and it should boot into Sprout.
|
||||||
|
|||||||
172
docs/setup/signed/fedora.md
Normal file
172
docs/setup/signed/fedora.md
Normal file
@@ -0,0 +1,172 @@
|
|||||||
|
# Setup Sprout for Fedora with Secure Boot
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
- Modern Fedora release: tested on Fedora 43 x86_64.
|
||||||
|
- EFI System Partition mounted on `/boot/efi` (the default)
|
||||||
|
- You will need the following packages installed: `openssl`, `mokutil`, `sbsigntools`, `efibootmgr`
|
||||||
|
|
||||||
|
**NOTE**: Fedora on ARM64 itself does not support Secure Boot consistently.
|
||||||
|
|
||||||
|
## Step 1: Generate and Install Secure Boot Key
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Create a directory to store the Secure Boot MOK key and certificates.
|
||||||
|
$ mkdir -p /etc/sprout/secure-boot
|
||||||
|
# Change to the created directory.
|
||||||
|
$ cd /etc/sprout/secure-boot
|
||||||
|
# Generate a MOK key and certificate.
|
||||||
|
$ openssl req \
|
||||||
|
-newkey rsa:4096 -nodes -keyout mok.key \
|
||||||
|
-new -x509 -sha256 -days 3650 -subj '/CN=Sprout Secure Boot/' \
|
||||||
|
-out mok.crt
|
||||||
|
# Generate a DER encoded certificate for enrollment.
|
||||||
|
$ openssl x509 -outform DER -in mok.crt -out mok.cer
|
||||||
|
# Import the certificate into the Secure Boot environment.
|
||||||
|
# This will ask you to make a password that will be used during enrollment.
|
||||||
|
$ mokutil --import mok.cer
|
||||||
|
# Reboot your machine.
|
||||||
|
# During boot, MOK enrollment should appear. If it doesn't, ensure you are booting into the shim.
|
||||||
|
# Press any key to begin MOK management. Select "Enroll MOK".
|
||||||
|
# Select "View key 0", and ensure the subject says "CN=Sprout Secure Boot".
|
||||||
|
# If the subject does not match, something has gone wrong with MOK enrollment.
|
||||||
|
# Press Enter to continue, then select the "Continue" option.
|
||||||
|
# When it asks to enroll the key, select the "Yes" option.
|
||||||
|
# Enter the password that you created during the mokutil --import step.
|
||||||
|
# Select "Reboot" to boot back into your Operating System.
|
||||||
|
```
|
||||||
|
|
||||||
|
## Step 2: Prepare the Secure Boot Environment
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Create a directory for Sprout EFI artifacts.
|
||||||
|
$ mkdir -p /boot/efi/EFI/sprout
|
||||||
|
|
||||||
|
# For x86_64, copy the following artifacts to the Sprout EFI directory.
|
||||||
|
$ cp /boot/efi/EFI/fedora/shimx64.efi /boot/efi/EFI/sprout/shimx64.efi
|
||||||
|
$ cp /boot/efi/EFI/fedora/mmx64.efi /boot/efi/EFI/sprout/mmx64.efi
|
||||||
|
|
||||||
|
# For aarch64, copy the following artifacts to the Sprout EFI directory.
|
||||||
|
$ cp /boot/efi/EFI/fedora/shimaa64.efi /boot/efi/EFI/sprout/shimaa64.efi
|
||||||
|
$ cp /boot/efi/EFI/fedora/mmaa64.efi /boot/efi/EFI/sprout/mmaa64.efi
|
||||||
|
```
|
||||||
|
|
||||||
|
## Step 3: Install Unsigned Sprout
|
||||||
|
|
||||||
|
Download the latest sprout.efi release from the [GitHub releases page](https://github.com/edera-dev/sprout/releases).
|
||||||
|
For x86_64 systems, download the `sprout-x86_64.efi` file, and for ARM64 systems, download the `sprout-aarch64.efi` file.
|
||||||
|
Copy the downloaded `sprout.efi` file to `/boot/efi/EFI/sprout/sprout.unsigned.efi` on your EFI System Partition.
|
||||||
|
|
||||||
|
## Step 4: Sign Sprout for Secure Boot
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# For x86_64, sign the unsigned Sprout artifact and name it grubx64.efi which is what the shim will call.
|
||||||
|
$ sbsign \
|
||||||
|
--key /etc/sprout/secure-boot/mok.key \
|
||||||
|
--cert /etc/sprout/secure-boot/mok.crt \
|
||||||
|
--output /boot/efi/EFI/sprout/grubx64.efi \
|
||||||
|
/boot/efi/EFI/sprout/sprout.unsigned.efi
|
||||||
|
|
||||||
|
# For aarch64, sign the unsigned Sprout artifact and name it grubaa64.efi which is what the shim will call.
|
||||||
|
$ sbsign \
|
||||||
|
--key /etc/sprout/secure-boot/mok.key \
|
||||||
|
--cert /etc/sprout/secure-boot/mok.crt \
|
||||||
|
--output /boot/efi/EFI/sprout/grubaa64.efi \
|
||||||
|
/boot/efi/EFI/sprout/sprout.unsigned.efi
|
||||||
|
```
|
||||||
|
|
||||||
|
## Step 5: Install and Sign EFI Drivers
|
||||||
|
|
||||||
|
You will need a filesystem EFI driver if `/boot` is not FAT32 or ExFAT.
|
||||||
|
|
||||||
|
### ext4
|
||||||
|
|
||||||
|
Most Fedora systems use an ext4 filesystem for `/boot`, if that is the case, use the ext4 instructions here:
|
||||||
|
|
||||||
|
Install the necessary `edk2-ext4` package:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Install the ext4 driver from the package manager.
|
||||||
|
$ dnf install edk2-ext4
|
||||||
|
```
|
||||||
|
|
||||||
|
Copy the ext4 driver to `/boot/efi/EFI/sprout/ext4.unsigned.efi`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# For x86_64, copy the ext4x64.efi driver to the Sprout EFI directory.
|
||||||
|
$ cp /usr/share/edk2/drivers/ext4x64.efi /boot/efi/EFI/sprout/ext4.unsigned.efi
|
||||||
|
|
||||||
|
# For aarch64, copy the ext4aa64.efi driver to the Sprout EFI directory.
|
||||||
|
$ cp /usr/share/edk2/drivers/ext4aa64.efi /boot/efi/EFI/sprout/ext4.unsigned.efi
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Sign the ext4 driver at ext4.unsigned.efi, placing it at ext4.efi, which will be used in the configuration.
|
||||||
|
$ sbsign \
|
||||||
|
--key /etc/sprout/secure-boot/mok.key \
|
||||||
|
--cert /etc/sprout/secure-boot/mok.crt \
|
||||||
|
--output /boot/efi/EFI/sprout/ext4.efi \
|
||||||
|
/boot/efi/EFI/sprout/ext4.unsigned.efi
|
||||||
|
```
|
||||||
|
|
||||||
|
### Other Filesystems
|
||||||
|
|
||||||
|
If you need another driver, you can download EFI filesystem drivers from [EfiFs releases](https://github.com/pbatard/EfiFs/releases).
|
||||||
|
Copy the driver to `/boot/efi/EFI/sprout/DRIVER_NAME.unsigned.efi` for signing, then sign it like this:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Sign your driver, placing it at DRIVER_NAME.efi, which will be used in the configuration.
|
||||||
|
$ sbsign \
|
||||||
|
--key /etc/sprout/secure-boot/mok.key \
|
||||||
|
--cert /etc/sprout/secure-boot/mok.crt \
|
||||||
|
--output /boot/efi/EFI/sprout/DRIVER_NAME.efi \
|
||||||
|
/boot/efi/EFI/sprout/DRIVER_NAME.unsigned.efi
|
||||||
|
```
|
||||||
|
|
||||||
|
You will add the driver in your Sprout configuration below, like this:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
[drivers.DRIVER_NAME]
|
||||||
|
path = "\\EFI\\sprout\\DRIVER_NAME.efi"
|
||||||
|
```
|
||||||
|
|
||||||
|
## Step 6: Create Sprout Configuration
|
||||||
|
|
||||||
|
Write the following to the file `/boot/efi/sprout.toml`:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
# sprout configuration: version 1
|
||||||
|
version = 1
|
||||||
|
|
||||||
|
# load an ext4 EFI driver.
|
||||||
|
# skip this if you do not have a filesystem driver.
|
||||||
|
# if your filesystem driver is not named ext4, change accordingly.
|
||||||
|
[drivers.ext4]
|
||||||
|
path = "\\EFI\\sprout\\ext4.efi"
|
||||||
|
|
||||||
|
# global options.
|
||||||
|
[options]
|
||||||
|
# enable autoconfiguration by detecting bls enabled
|
||||||
|
# filesystems and generating boot entries for them.
|
||||||
|
autoconfigure = true
|
||||||
|
```
|
||||||
|
|
||||||
|
Ensure you add the signed driver paths to the configuration, not the unsigned ones.
|
||||||
|
If you do not have any drivers, exclude the drivers section entirely.
|
||||||
|
|
||||||
|
## Step 7: Configure Sprout Boot Entry
|
||||||
|
|
||||||
|
In the following commands, replace /dev/BLOCK_DEVICE with the device that houses your GPT partition table,
|
||||||
|
and PARTITION_NUMBER with the partition number of the EFI System Partition. For example, if your EFI System Partition is
|
||||||
|
`/dev/sda1`, the BLOCK_DEVICE would be `/dev/sda` and the PARTITION_NUMBER would be `1`
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# For x86_64, run this command to add Sprout as the default boot entry.
|
||||||
|
$ efibootmgr -d /dev/BLOCK_DEVICE -p PARTITION_NUMBER -c -L 'Sprout' -l '\EFI\sprout\shimx64.efi'
|
||||||
|
|
||||||
|
# For aarch64, run this command to add Sprout as the default boot entry.
|
||||||
|
$ efibootmgr -d /dev/BLOCK_DEVICE -p PARTITION_NUMBER -c -L 'Sprout' -l '\EFI\sprout\shimaa64.efi'
|
||||||
|
```
|
||||||
|
|
||||||
|
Reboot your machine and it should boot into Sprout.
|
||||||
|
If Sprout fails to boot, it should boot into the original bootloader.
|
||||||
@@ -128,11 +128,13 @@ If you do not have any drivers, exclude the drivers section entirely.
|
|||||||
|
|
||||||
## Step 7: Configure Sprout Boot Entry
|
## Step 7: Configure Sprout Boot Entry
|
||||||
|
|
||||||
In the following commands, replace /dev/ESP_PARTITION with the actual path to the ESP partition block device.
|
In the following commands, replace /dev/BLOCK_DEVICE with the device that houses your GPT partition table,
|
||||||
|
and PARTITION_NUMBER with the partition number of the EFI System Partition. For example, if your EFI System Partition is
|
||||||
|
`/dev/sda1`, the BLOCK_DEVICE would be `/dev/sda` and the PARTITION_NUMBER would be `1`
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Run this command to add Sprout as the default boot entry.
|
# Run this command to add Sprout as the default boot entry.
|
||||||
$ efibootmgr -d /dev/ESP_PARTITION -c -L 'Sprout' -l '\EFI\sprout\shim.efi'
|
$ efibootmgr -d /dev/BLOCK_DEVICE -p PARTITION_NUMBER -c -L 'Sprout' -l '\EFI\sprout\shim.efi'
|
||||||
```
|
```
|
||||||
|
|
||||||
Reboot your machine and it should boot into Sprout.
|
Reboot your machine and it should boot into Sprout.
|
||||||
|
|||||||
@@ -59,7 +59,7 @@ Copy the downloaded `sprout.efi` file to `/boot/efi/EFI/sprout/sprout.unsigned.e
|
|||||||
## Step 4: Sign Sprout for Secure Boot
|
## Step 4: Sign Sprout for Secure Boot
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# For x86_64, sign the unsigned Sprout artifact and name it grubaa64.efi which is what the shim will call.
|
# For x86_64, sign the unsigned Sprout artifact and name it grubx64.efi which is what the shim will call.
|
||||||
$ sbsign \
|
$ sbsign \
|
||||||
--key /etc/sprout/secure-boot/mok.key \
|
--key /etc/sprout/secure-boot/mok.key \
|
||||||
--cert /etc/sprout/secure-boot/mok.crt \
|
--cert /etc/sprout/secure-boot/mok.crt \
|
||||||
@@ -119,8 +119,8 @@ path = "\\EFI\\sprout\\ext4.efi"
|
|||||||
|
|
||||||
# global options.
|
# global options.
|
||||||
[options]
|
[options]
|
||||||
# enable autoconfiguration by detecting bls enabled
|
# enable autoconfiguration by detecting installed kernels
|
||||||
# filesystems and generating boot entries for them.
|
# generating boot entries for them.
|
||||||
autoconfigure = true
|
autoconfigure = true
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -129,14 +129,18 @@ If you do not have any drivers, exclude the drivers section entirely.
|
|||||||
|
|
||||||
## Step 7: Configure Sprout Boot Entry
|
## Step 7: Configure Sprout Boot Entry
|
||||||
|
|
||||||
In the following commands, replace /dev/ESP_PARTITION with the actual path to the ESP partition block device.
|
## Step 7: Configure Sprout Boot Entry
|
||||||
|
|
||||||
|
In the following commands, replace /dev/BLOCK_DEVICE with the device that houses your GPT partition table,
|
||||||
|
and PARTITION_NUMBER with the partition number of the EFI System Partition. For example, if your EFI System Partition is
|
||||||
|
`/dev/sda1`, the BLOCK_DEVICE would be `/dev/sda` and the PARTITION_NUMBER would be `1`
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# For x86_64, run this command to add Sprout as the default boot entry.
|
# For x86_64, run this command to add Sprout as the default boot entry.
|
||||||
$ efibootmgr -d /dev/ESP_PARTITION -c -L 'Sprout' -l '\EFI\sprout\shimx64.efi'
|
$ efibootmgr -d /dev/BLOCK_DEVICE -p PARTITION_NUMBER -c -L 'Sprout' -l '\EFI\sprout\shimx64.efi'
|
||||||
|
|
||||||
# For aarch64, run this command to add Sprout as the default boot entry.
|
# For aarch64, run this command to add Sprout as the default boot entry.
|
||||||
$ efibootmgr -d /dev/ESP_PARTITION -c -L 'Sprout' -l '\EFI\sprout\shimaa64.efi'
|
$ efibootmgr -d /dev/BLOCK_DEVICE -p PARTITION_NUMBER -c -L 'Sprout' -l '\EFI\sprout\shimaa64.efi'
|
||||||
```
|
```
|
||||||
|
|
||||||
Reboot your machine and it should boot into Sprout.
|
Reboot your machine and it should boot into Sprout.
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
FROM --platform=$BUILDPLATFORM debian:trixie@sha256:fd8f5a1df07b5195613e4b9a0b6a947d3772a151b81975db27d47f093f60c6e6 AS build
|
FROM --platform=$BUILDPLATFORM debian:trixie@sha256:01a723bf5bfb21b9dda0c9a33e0538106e4d02cce8f557e118dd61259553d598 AS build
|
||||||
ARG BUILDPLATFORM
|
ARG BUILDPLATFORM
|
||||||
ARG EFI_NAME
|
ARG EFI_NAME
|
||||||
RUN export DEBIAN_FRONTEND=noninteractive && apt-get update && apt-get install -y \
|
RUN export DEBIAN_FRONTEND=noninteractive && apt-get update && apt-get install -y \
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
ARG KERNEL_SOURCE_URL=https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.17.2.tar.xz
|
ARG KERNEL_SOURCE_URL=https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.17.8.tar.xz
|
||||||
ARG KERNEL_CHECKSUM=sha256:fdebcb065065f5c1b8dc68a6fb59cda50cdddbf9103d207c2196d55ea764f57f
|
ARG KERNEL_CHECKSUM=sha256:5a8de64a75fca706c01c6c0a77cf75a74618439db195e25f1f0268af6b2fb1da
|
||||||
|
|
||||||
FROM --platform=$BUILDPLATFORM debian:trixie@sha256:fd8f5a1df07b5195613e4b9a0b6a947d3772a151b81975db27d47f093f60c6e6 AS buildenv
|
FROM --platform=$BUILDPLATFORM debian:trixie@sha256:01a723bf5bfb21b9dda0c9a33e0538106e4d02cce8f557e118dd61259553d598 AS buildenv
|
||||||
RUN export DEBIAN_FRONTEND=noninteractive && apt-get update && apt-get install -y \
|
RUN export DEBIAN_FRONTEND=noninteractive && apt-get update && apt-get install -y \
|
||||||
build-essential squashfs-tools python3-yaml \
|
build-essential squashfs-tools python3-yaml \
|
||||||
patch diffutils sed mawk findutils zstd \
|
patch diffutils sed mawk findutils zstd \
|
||||||
|
|||||||
@@ -1 +1 @@
|
|||||||
FROM --platform=$BUILDPLATFORM debian:trixie@sha256:fd8f5a1df07b5195613e4b9a0b6a947d3772a151b81975db27d47f093f60c6e6
|
FROM --platform=$BUILDPLATFORM debian:trixie@sha256:01a723bf5bfb21b9dda0c9a33e0538106e4d02cce8f557e118dd61259553d598
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
ARG TARGET_IMAGE=scratch
|
ARG TARGET_IMAGE=scratch
|
||||||
FROM ${TARGET_IMAGE} AS image
|
FROM ${TARGET_IMAGE} AS image
|
||||||
FROM --platform=$BUILDPLATFORM debian:trixie@sha256:fd8f5a1df07b5195613e4b9a0b6a947d3772a151b81975db27d47f093f60c6e6 AS final
|
FROM --platform=$BUILDPLATFORM debian:trixie@sha256:01a723bf5bfb21b9dda0c9a33e0538106e4d02cce8f557e118dd61259553d598 AS final
|
||||||
COPY --from=image / /image
|
COPY --from=image / /image
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
FROM alpine:3.22@sha256:4bcff63911fcb4448bd4fdacec207030997caf25e9bea4045fa6c8c44de311d1 AS rootfs
|
FROM alpine:3.22@sha256:4b7ce07002c69e8f3d704a9c5d6fd3053be500b7f1c69fc0d80990c2ad8dd412 AS rootfs
|
||||||
RUN apk --no-cache add alpine-base tzdata
|
RUN apk --no-cache add alpine-base tzdata
|
||||||
RUN rc-update add devfs sysinit && \
|
RUN rc-update add devfs sysinit && \
|
||||||
rc-update add dmesg sysinit && \
|
rc-update add dmesg sysinit && \
|
||||||
@@ -18,7 +18,7 @@ RUN rc-update add devfs sysinit && \
|
|||||||
ln -s /usr/share/zoneinfo/UTC /etc/localtime && \
|
ln -s /usr/share/zoneinfo/UTC /etc/localtime && \
|
||||||
echo 'hvc0::respawn:/sbin/getty -L hvc0 115200 vt100' >> /etc/inittab
|
echo 'hvc0::respawn:/sbin/getty -L hvc0 115200 vt100' >> /etc/inittab
|
||||||
|
|
||||||
FROM alpine:3.22@sha256:4bcff63911fcb4448bd4fdacec207030997caf25e9bea4045fa6c8c44de311d1 AS build
|
FROM alpine:3.22@sha256:4b7ce07002c69e8f3d704a9c5d6fd3053be500b7f1c69fc0d80990c2ad8dd412 AS build
|
||||||
COPY --from=rootfs / /rootfs
|
COPY --from=rootfs / /rootfs
|
||||||
WORKDIR /rootfs
|
WORKDIR /rootfs
|
||||||
RUN find . | cpio -R 0:0 --ignore-devno --renumber-inodes -o -H newc --quiet > /initramfs
|
RUN find . | cpio -R 0:0 --ignore-devno --renumber-inodes -o -H newc --quiet > /initramfs
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
FROM alpine:3.22@sha256:4bcff63911fcb4448bd4fdacec207030997caf25e9bea4045fa6c8c44de311d1 AS build
|
FROM alpine:3.22@sha256:4b7ce07002c69e8f3d704a9c5d6fd3053be500b7f1c69fc0d80990c2ad8dd412 AS build
|
||||||
ARG TARGETPLATFORM
|
ARG TARGETPLATFORM
|
||||||
RUN if [ "${TARGETPLATFORM}" = "linux/amd64" ] || [ "${TARGETPLATFORM}" = "linux/x86_64" ]; then \
|
RUN if [ "${TARGETPLATFORM}" = "linux/amd64" ] || [ "${TARGETPLATFORM}" = "linux/x86_64" ]; then \
|
||||||
apk --no-cache add ovmf edk2-shell; cp /usr/share/ovmf/bios.bin /ovmf.fd; fi
|
apk --no-cache add ovmf edk2-shell; cp /usr/share/ovmf/bios.bin /ovmf.fd; fi
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
FROM alpine:3.22@sha256:4bcff63911fcb4448bd4fdacec207030997caf25e9bea4045fa6c8c44de311d1 AS build
|
FROM alpine:3.22@sha256:4b7ce07002c69e8f3d704a9c5d6fd3053be500b7f1c69fc0d80990c2ad8dd412 AS build
|
||||||
ARG TARGETPLATFORM
|
ARG TARGETPLATFORM
|
||||||
RUN apk add --no-cache xen-hypervisor && cp /usr/lib/efi/xen.efi /xen.efi
|
RUN apk add --no-cache xen-hypervisor && cp /usr/lib/efi/xen.efi /xen.efi
|
||||||
|
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
[toolchain]
|
[toolchain]
|
||||||
channel = "1.91.0"
|
channel = "1.91.1"
|
||||||
components = ["rustfmt", "clippy"]
|
components = ["rustfmt", "clippy"]
|
||||||
targets = ["x86_64-unknown-uefi", "aarch64-unknown-uefi"]
|
targets = ["x86_64-unknown-uefi", "aarch64-unknown-uefi"]
|
||||||
|
|||||||
Reference in New Issue
Block a user