Skip to content

config: add Secure Boot option for Apple UEFI guests - #7886

Open
osy wants to merge 1 commit into
mainfrom
feature/apple-secure-boot
Open

osy wants to merge 1 commit into
mainfrom
feature/apple-secure-boot

Conversation

@osy

@osy osy commented Sep 20, 2026

Copy link
Copy Markdown
Contributor

macOS 27 lets the host manage Secure Boot state in a VZEFIVariableStore. This adds a "Secure Boot" option for generic UEFI guests on the Apple Virtualization backend.

  • New SecureBoot key in the Apple boot configuration (defaults to off; older configurations load unchanged).
  • A "Secure Boot" toggle in the Boot settings, shown on macOS 27 when the bootloader is UEFI.
  • The variable store is reconciled when the configuration is saved: enabling enrolls the default Microsoft signatures and the default platform key so mainstream Linux distributions boot unmodified; disabling keeps the enrolled keys so it can be turned back on. The store is only written when its state differs from the configuration, and a VM with the option off never fails to save because of it.
  • Localized messages for the new EFI variable store errors.

The option defaults to off because guests without a Microsoft-signed bootloader would otherwise stop booting. There are no wizard or scripting changes.

Resolves #7874

Testing: Tested by a human on macOS 27.0 (26A428), MacBook Air (Apple M3). The author acknowledges that this change has been tested and/or reviewed by a human in accordance with UTM's AI contribution guidelines.

Checked with the Debian 13 arm64 installer: with the option on the guest boots through shim and GRUB reports prohibited by secure boot policy for insmod; a disk whose only loader is not Microsoft-signed is refused by the firmware; with the option off both boot normally; re-enabling after disabling works.

macOS 27 lets the host manage Secure Boot state in the EFI variable
store. Add a persisted flag and a toggle in the Boot settings so generic
UEFI guests on the Apple backend can opt in. The state is reconciled when
the configuration is saved, using the default platform key and the
default Microsoft signatures so that mainstream Linux distributions boot
unmodified. The store is only written when its state differs from the
configuration, and a virtual machine with the option off never fails to
save because of it. The option defaults to off because guests without a
Microsoft-signed bootloader would otherwise stop booting.

Assisted-by: Claude:claude-fable-5-1
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.

Add EFI Secure Boot Support for Linux Guests running Apple Virtualisation Framework.

1 participant