Skip to content

elevate: Document that Secure Boot must be disabled for cross-vendor upgrades - #884

Merged
andrewlukoshko merged 1 commit into
AlmaLinux:masterfrom
yuravk:elevate-secure-boot-note
Nov 12, 2026
Merged

andrewlukoshko merged 1 commit into
AlmaLinux:masterfrom
yuravk:elevate-secure-boot-note

Conversation

@yuravk

@yuravk yuravk commented Nov 12, 2026

Copy link
Copy Markdown
Contributor

With Secure Boot enabled, the ELevate-Upgrade-Initramfs entry fails to boot with invalid signature when the target OS comes from a different vendor than the installed one, for example CentOS 7 to AlmaLinux 8. The upgrade kernel is signed by the target OS vendor, while the system is still started by the shim of the installed OS.

Changes:

  • ELevate Frequent Issues: new section "The upgrade entry fails to boot with "invalid signature" when Secure Boot is enabled" with the error, how to check the Secure Boot state, the explanation, the workaround (disable Secure Boot for the upgrade, enable it again afterwards), and how to recover after a failed reboot. It also notes that upgrades from EL8 and EL9 based systems to another distribution are inhibited by leapp preupgrade, while the CentOS 7 path has no such check.
  • ELevate Quickstart Guide: a warning in Requirements that links to the new section.

Related: AlmaLinux/leapp-repository#159

…upgrades

With Secure Boot enabled, the upgrade entry fails to boot with
"invalid signature" when the target OS comes from a different vendor
than the installed one (e.g. CentOS 7 to AlmaLinux 8): the upgrade
kernel is signed by the target OS vendor, while the system is still
started by the shim of the installed OS.

Add a Frequent Issues section with the error, the explanation, the
workaround (disable Secure Boot for the upgrade) and how to recover
after a failed reboot. Note that upgrades from EL8 and EL9 based systems
are inhibited by leapp in this case, while the CentOS 7 path has no such
check. Add a warning to the Requirements of the Quickstart Guide.

Related: AlmaLinux/leapp-repository#159
@andrewlukoshko
andrewlukoshko merged commit 576043a into AlmaLinux:master Nov 12, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants