Skip to content

docs: note that SecureBoot disables kexec reboots - #933

Open
Iheanacho-ai wants to merge 1 commit into
siderolabs:mainfrom
Iheanacho-ai:talos-secureboot-kexec
Open

Iheanacho-ai wants to merge 1 commit into
siderolabs:mainfrom
Iheanacho-ai:talos-secureboot-kexec

Conversation

@Iheanacho-ai

Copy link
Copy Markdown
Member

What

Notes that Talos Linux doesn't reboot with kexec when SecureBoot is enabled, on the Upgrading Talos and SecureBoot pages for v1.14 and v1.15.

Why

The Upgrading Talos page said that because Talos Linux reboots via kexec, the extra reboot adds very little time. This isn't true on SecureBoot machines, which reboot through the firmware. A customer saw 25+ minute upgrades for this reason, and the docs had no mention of it (requested by Steve Francis in #team-eng).

Change

  • Upgrading Talos: After the kexec sentence, added that machines with SecureBoot enabled reboot through the firmware instead, which takes longer. Links to the SecureBoot page.
  • SecureBoot, Upgrading Talos Linux section: Added that with SecureBoot enabled, Talos Linux reboots through the UEFI firmware rather than with kexec, so upgrades and reboots take as long as a full boot.
  • SecureBoot: Split four code blocks that mixed a $ prompt with output into a command block and an output block, as the style check requires.

Testing

  • Ran: Checked the behavior in the Talos source. KexecPrepare (internal/app/machined/pkg/runtime/v1alpha1/v1alpha1_sequencer_tasks.go) returns early when SecureBoot is enabled and logs kexec skipped as secure boot is enabled. It runs for upgrades, and reboots go through the same check. The check is present in v1.13.0, v1.14.0, and main.
  • Ran: make style-check-changed-local (0 errors), make check-frontmatter-changed, and make canonical-links-check. All pass.
  • Where: Source review and local checks. No upgrade was run on a SecureBoot machine.
  • By: An agent (Claude Code), reviewed by me.
  • Filled from outside the page: The behavior was confirmed by Andrey Smirnov in #team-eng and verified in the code.

@mintlify

mintlify Bot commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

Preview approval required

This pull request comes from a fork, so Mintlify won't build a preview until someone with write access approves commit 9a3d096.

Approve preview

@Iheanacho-ai
Iheanacho-ai force-pushed the talos-secureboot-kexec branch from 8be9d37 to 2425a12 Compare November 11, 2026 08:56
@github-actions

github-actions Bot commented Nov 11, 2026 •

Copy link
Copy Markdown

Superseded: a later run (commit 9a3d096) completed.

Talos Linux skips kexec when SecureBoot is enabled, so upgrades and
reboots go through the firmware. Say so on the upgrade and SecureBoot
pages for v1.14 and v1.15, and split the SecureBoot command examples
into command and output blocks.

Signed-off-by: Amarachi Iheanacho <amarachi.iheanacho@siderolabs.com>
@Iheanacho-ai
Iheanacho-ai force-pushed the talos-secureboot-kexec branch from 2425a12 to 9a3d096 Compare November 11, 2026 09:00

This branch has not been deployed

No deployments
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