This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Releases

See https://github.com/lima-vm/lima/releases for the latest release.

Lifecycle

ReleaseBeginEnd
v2.x2025-11-06Undecided (v3 Begin + 3 months)
v1.x2024-11-062026-02-06 (v2 Begin + 3 months)
v0.x2021-05-142024-11-06 (v1 Begin + 0 days)

Since Lima v1.x, each major release receives security updates and critical bug fixes until three months after the next major release.

1 - Deprecated features

The following features are deprecated:

  • limactl show-ssh command: deprecated in v0.18.0 (Use ssh -F ~/.lima/default/ssh.config lima-default instead)
  • Ansible provisioning mode: deprecated in Lima v1.1.0 (Use ansible-playbook playbook.yaml after the start instead)
  • limactl --yes flag: deprecated in Lima v2.0.0 (Use limactl (clone|rename|edit|shell) --start instead)

Removed features

  • YAML property network: deprecated in Lima v0.7.0 and removed in Lima v0.14.0, in favor of networks
  • YAML property useHostResolver: deprecated in Lima v0.8.1 and removed in Lima v0.14.0,in favor of hostResolver.enabled
  • VDE support, including VNL and vde_vmnet: deprecated in Lima v0.12.0 and removed in Lima v0.22.0, in favor of socket_vmnet
  • CentOS 7 guest support: deprecated in Lima v0.9.2 and removed in Lima v0.23.0, in favor of CentOS Stream, AlmaLinux, and Rocky Linux.

Undeprecated features

  • Loading non-strict YAMLs (i.e., YAMLs with unknown properties): once deprecated in Lima v0.12.0, but undeprecated in Lima v1.0.4

2 - Experimental features

The following features are experimental and subject to change:

  • mountType: virtiofs on Linux
  • vmType: wsl2 and relevant configurations (mountType: wsl2)
  • arch: riscv64, armv7l, s390x, and ppc64le
  • video.display: vnc and relevant configuration (video.vnc.display)
  • audio.device
  • mountInotify: true
  • External drivers: building and using drivers as separate executables (see Virtual Machine Drivers)
  • vmType: krunkit

The following commands are experimental and subject to change:

  • limactl snapshot *
  • limactl tunnel
  • limactl template *
  • limactl mcp *

Graduated

The following features were experimental in the past:

Until v1.0

  • mountType: 9p
  • vmType: vz and relevant configurations (mountType: virtiofs, rosetta, []networks.vzNAT)
  • mode: user-v2 in networks.yml and relevant configuration in lima.yaml

3 - Breaking changes

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.