Refactor `guestpatch/macos` to use `VZMacGuestProvisioningOptions` for macOS 27+ guests · Issue #5516 · lima-vm/lima · GitHub
Skip to content

Refactor guestpatch/macos to use VZMacGuestProvisioningOptions for macOS 27+ guests #5516

Open

Description

@AkihiroSuda

Some part of guestpatch/macos.Patch should no longer be needed for macOS 27+ guests: https://developer.apple.com/documentation/virtualization/vzmacguestprovisioningoptions

Note

This configuration requires guest macOS 27 or later to function properly. Earlier versions of macOS don’t support the automated guest configuration protocol and ignore these settings.

This configuration class provides automated setup capabilities for macOS virtual machines that allow hosts to configure a user account and initial setup workflows without manual intervention during the guest boot process.

The configuration enables automated macOS installation and setup workflows by providing user credentials and setup preferences to the guest system during startup.
macOS only evaluates these options on the first boot after restore. The Virtualization framework can’t use them to reconfigure macOS once the framework has already provisioned it.

Changes to the properties after starting the virtual machine have no effect.

It still has to remain functional for older guests.

Activity

  1. changed the title [-]Replace `guestpatch/macos` with `VZMacGuestProvisioningOptions` for macOS 27+ guests[/-] [+]Refactor `guestpatch/macos` to use `VZMacGuestProvisioningOptions` for macOS 27+ guests[/+] on Sep 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions