v1.0.0

[AkihiroSuda]

With the support from 110+ contributors in 3+ years, the Lima project has finally reached v1.0. 🎉

This release introduces several breaking changes, such as switching the default machine driver from QEMU to VZ for better filesystem performance.

The limactl CLI is designed to print hints when the user hits those breaking changes.
e.g., limactl create template://experimental/vz now fails with a hint that suggests using limactl create --vm-type=vz template://default instead.

🔴 = Major breaking changes
🟡 = Minor breaking changes

• VZ:

  • Graduate VZ machine driver from experimental (Remove experimental notice for vz, 9p, user-v2 net, grpc forwarder #2758)
  • 🔴 Use VZ by default for new instances on macOS >= 13.5 ( Use VZ by default for new instances on macOS >= 13.5 #1951)
  • Support nested virtualization on M3 (vz: add support for nested virtualization #2530, thanks to @abiosoft)
  • Optimize qcow2-to-raw image conversion (lima-vm/go-qcow2reader@v0.1.2...v0.4.0 , thanks to @nirs)
  • Support specifying a custom kernel (VZ: Support Kernel Image #2562, thanks to @norio-nomura)

• QEMU:

  • Graduate 9p mount driver from experimental (Remove experimental notice for vz, 9p, user-v2 net, grpc forwarder #2758)
  • 🔴 Use 9p by default for most templates (qemu: use 9p by default #1953, templates: update fedora to 41; templates: disable 9p for Linux 6.9-6.11 #2822)
  • riscv64: switch from u-boot to EDK2 (qemu: riscv64: switch from u-boot to EDK2 #2592)

• Network:

  • Graduate user-v2 network driver from experimental (Remove experimental notice for vz, 9p, user-v2 net, grpc forwarder #2758)
  • Support UDP port forwarding (Revamp port forwarding to support UDP #2411, thanks to @balajiv113)
  • 🔴 Strictly require socket_vmnet binary to be owned by root (networks.Validate() requires that socket_vmnet is owned by root #2734)

• SSH:

  • 🟡 Disable ssh.loadDotSSHPubKeys by default (Disable ssh.loadDotSSHPubKeys by default #2706)

• YAML:

  • Support generating jsonschema (Add command to generate jsonschema for limayaml #2306, thanks to @afbjorklund)
  • Support specifying param for provisioning scripts (Add limayaml param settings to provisioning script environment #2570, thanks to @jandubois)
  • Support specifying minimumLimaVersion and vmOpts.qemu.minimumVersion (Add minimumLimaVersion and vmOpts.qemu.minimumVersion fields to lima.yaml #2659, thanks to @jandubois)
  • Support template expansion in mounts (limayaml: support template expansion in .mounts[].location and .mounts[].mountPoint #2588, thanks to @norio-nomura)

• limactl CLI:

  • Add limactl tunnel command so as to allow the host to join the guest network (limactl: add tunnel command (experimental) #2710)
  • Add --log-format=json (Add --log-format json option #2584, thanks to @nirs)
  • limactl prune: Add --keep-referred (limactl prune: add --keep-referred option to keep objects that are referred by some instances or templates #2569, thanks to @norio-nomura)

• nerdctl:

  • Updated to v2.0.0 (nerdctl: update to v2.0.0 #2178)
  • rootless: allocate 1G subuids from 524288 (0x80000) for new users (rootless: allocate 1G subuids from 524288 (0x80000) #2725)

• Templates:

  • 🔴 experimental/vz: Merged into the default template (templates: merge experimental/{riscv64,armv7l} into default #2730, templates: remove vz, vmnet, etc. in favor of the limactl CLI args #2736)
  • 🟡 experimental/{riscv64, armv7l}: Merged into the default template (templates: merge experimental/{riscv64,armv7l} into default #2730, templates: remove vz, vmnet, etc. in favor of the limactl CLI args #2736)
  • 🔴 vmnet: Removed in favor of limactl create --network=lima:shared template://default (templates: remove vz, vmnet, etc. in favor of the limactl CLI args #2736)
  • 🟡 experimental/net-user-v2: Removed in favor of limactl create --network=lima:user-v2 template://default (templates: remove vz, vmnet, etc. in favor of the limactl CLI args #2736)
  • 🔴 experimental/9p: Removed in favor of limactl create --mount-type=9p template://default (templates: remove vz, vmnet, etc. in favor of the limactl CLI args #2736)
  • 🟡 experimental/virtiofs-linux: Removed in favor of limactl create --mount-type=virtiofs template://default (templates: remove vz, vmnet, etc. in favor of the limactl CLI args #2736)
  • 🔴 alpine: Renamed to alpine-iso (templates: replace alpine with alpine-image #2704)
  • 🔴 alpine-image: Renamed to alpine (templates: replace alpine with alpine-image #2704)
  • archlinux: Demoted from Tier 1 to Tier 2 (CI: temporarily remove ArchLinux (and demote it from Tier 1) #2717, CI: add back archlinux #2823)
  • default, ubuntu, ...: Updated to Ubuntu 24.10. The older versions are available as ubuntu-20.04, ubuntu-22.04, and ubuntu-24.04 (templates: update Ubuntu to 24.10 #2755, templates: add ubuntu-20.04, ubuntu-22.04 #2795)
  • fedora: Updated to Fedora 41 (Update fedora template to f41 #2821, templates: update fedora to 41; templates: disable 9p for Linux 6.9-6.11 #2822, thanks to @subpop)
  • opensuse: Renamed to opensuse-leap. Still aliased as opensuse (Rename opensuse to opensuse-leap #2612, thanks to @afbjorklund)
  • experimental/opensuse-tumbleweed: Support aarch64 (Add the aarch64 cloud image for tumbleweed #2613, thanks to @afbjorklund)
  • hack/update-template.sh is added for automating updates (Automation for updating templates #1347, thanks to @norio-nomura)

• Project:

  • Invite Norio Nomura (@norio-nomura) as a Reviewer (MAINTAINERS: invite Norio Nomura (norio-nomura) as a Reviewer #2567)

Full changes: https://github.com/lima-vm/lima/milestone/47?closed=1
Thanks to @AdamKorcz @Mr-Sunglasses @SmartManoj @YorikSar @abiosoft @afbjorklund @alexandear @balajiv113 @hasan4791 @jandubois @nirs @norio-nomura @pvdvreede @subpop @tsukasaI

Usage

[macOS]$ limactl create
[macOS]$ limactl start
...
INFO[0029] READY. Run `lima` to open the shell.

[macOS]$ lima uname
Linux

---

The binaries were built automatically on GitHub Actions.
The build log is available for 90 days: https://github.com/lima-vm/lima/actions/runs/11695321667

The sha256sum of the SHA256SUMS file itself is 4bd200a163111fe78c6f3e6de405113d416053802fe1507597f9a42f89a98c90 .

---

Release manager: @AkihiroSuda

---

This discussion was created from the release v1.0.0.