Skip to content

Commit cbbdbb1

Browse files
Apply Microsoft review feedback to Secure Boot page
- Use fwupdmgr --version | grep fwupd (works on AlmaLinux 8 too) and state the expected minimum/current versions - Scope the fwupd step title to AlmaLinux 9 and later - Point AlmaLinux 8 users to the alternative enrollment from the fwupd note - Mention older AlmaLinux/fwupd releases in the manual enrollment intro
1 parent 104ee85 commit cbbdbb1

1 file changed

Lines changed: 6 additions & 4 deletions

File tree

docs/documentation/secure-boot-2023-certificates.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -78,17 +78,19 @@ If both commands print a match, your system is already up to date and you are do
7878

7979
Many recent machines already received the 2023 certificates through a firmware (BIOS/UEFI) update from the hardware vendor, so check for vendor firmware updates first — that is the cleanest path.
8080

81-
## Step 2 (recommended): Enroll the 2023 certificates with fwupd
81+
## Step 2 (recommended): Enroll the 2023 certificates with fwupd in AlmaLinux 9 and later
8282

8383
Like RHEL, AlmaLinux recommends **fwupd** for Secure Boot variable updates. fwupd delivers Microsoft's signed db/KEK update payloads through the [Linux Vendor Firmware Service (LVFS)](https://fwupd.org/), and contains quirk handling for firmware implementations that need special treatment.
8484

8585
Support for UEFI db and KEK updates was added in fwupd **2.0.8**. AlmaLinux 9 and 10 ship fwupd **2.0.19** in BaseOS, so the stock package is sufficient. AlmaLinux 8 ships fwupd 1.7.8, which cannot deliver these updates — on AlmaLinux 8, use a vendor firmware update or the manual method below instead.
8686

8787
```bash
8888
sudo dnf install -y fwupd
89-
fwupd --version
89+
fwupdmgr --version | grep fwupd
9090
```
9191

92+
The reported fwupd version must be **2.0.8** or later — on AlmaLinux 9 and 10 the stock package currently reports **2.0.19**.
93+
9294
Refresh metadata and apply available updates:
9395

9496
```bash
@@ -99,7 +101,7 @@ sudo reboot
99101

100102
If updates are available for your system, `fwupdmgr update` will list devices such as _UEFI db_ and _KEK_ with pending _Secure Boot_ certificate updates and prompt for confirmation. The new certificates only become visible after a reboot.
101103

102-
> **Note:** older fwupd versions (before 2.0.8) do not attempt db/KEK updates at all and may appear to "succeed" while doing nothing. Always verify the result (Step 3) instead of trusting the tool output alone.
104+
> **Note:** older fwupd versions (before 2.0.8) do not attempt db/KEK updates at all and may appear to "succeed" while doing nothing. Always verify the result (Step 3) instead of trusting the tool output alone. At the time of this writing, AlmaLinux 8 ships with an older release of fwupd, please see the alternative enrollment below.
103105
104106
## Step 3: Verify after reboot
105107

@@ -112,7 +114,7 @@ Both should now print the corresponding `Subject:` lines shown in Step 1. If the
112114

113115
## Alternative: manual enrollment without fwupd
114116

115-
For air-gapped systems, or if fwupd does not offer the update on your platform, Microsoft publishes the signed authenticated-variable update payloads in the [microsoft/secureboot_objects](https://github.com/microsoft/secureboot_objects) repository. The db update can be appended with `efivar` (available in the standard AlmaLinux repositories):
117+
For air-gapped systems, older releases of AlmaLinux/fwupd, or if fwupd does not offer the update on your platform, Microsoft publishes the signed authenticated-variable update payloads in the [microsoft/secureboot_objects](https://github.com/microsoft/secureboot_objects) repository. The db update can be appended with `efivar` (available in the standard AlmaLinux repositories):
116118

117119
```bash
118120
sudo dnf install -y efivar

0 commit comments

Comments
 (0)