Breaking changes

v2.3.0

  • The experimental _LIMA_WINDOWS_EXTRA_PATH environment variable was removed. It prepended directories to limactl.exe’s own PATH on Windows hosts, leaving the calling shell’s PATH untouched. Put them on PATH instead.
  • The SnapshotManager.ListSnapshots() method now returns structured snapshot metadata instead of raw text. ApplySnapshot() and DeleteSnapshot() now identify snapshots by ID instead of tag. External drivers must update their snapshot implementations and regenerate their protobuf bindings.

v2.2.0

  • The default socket_vmnet group in networks.yaml was changed from everyone to admin. A non-admin user must set group to a group they belong to (e.g. staff).
  • The default VM driver on Windows hosts was changed from wsl2 to qemu, as wsl2 is not compatible with most templates.
  • External driver transport was reworked:
    • The Driver.FillConfig() method was removed; its logic was merged into Driver.Configure(), which now returns (*ConfiguredDriver, error).
    • The external driver gRPC server socket moved from the OS temp directory (/tmp/lima-driver-<name>-<pid>.sock) to the instance directory (~/.lima/<instance>/lima-driver-<name>.sock).
    • External driver authors must update their drivers to match the new driver.Driver interface.

v2.0.0

  • /tmp/lima is no longer mounted by default.
  • SSH port is no longer hard-coded to 60022 for the “default” instance.
  • Port forwarding with sudo nerdctl run -p no longer works with nerdctl prior to v2.1.6.
  • The default of guestIPMustBeZero was changed from false to true when guestIP is 0.0.0.0.

v1.1.0

  • The lima-additional-guestagent package was split from the main lima package.

v1.0.0

  • The default VM type was changed from qemu to vz on macOS hosts with the support for vz.
  • The default mount type was changed from reverse-sshfs to virtiofs for vz, 9p for qemu.
  • socket_vmnet binary has to be strictly owned by root.
  • The default value of ssh.loadDotSSHPubKeys was changed from true to false.
  • Several templates were removed or renamed.

v0.22.0

  • Support for vde_vmnet was dropped in favor of socket_vmnet.

v0.3.0

  • limactl start no longer starts a VM in the foreground.

See also https://github.com/lima-vm/lima/releases.

Last modified October 5, 2026: fix: dead link from website content (349adbc4)