v1.0.4

Changes

• network:
  • Use MAC address as dhcpd identifier (#3123, thanks to @nirs)
  • Updated gvisor-tap-vsock to v0.8.2 to fix a DNS issue (#3133)
• YAML:
  • Un-deprecate non-strict YAML (#3104, thanks to @jandubois)
• nerdctl:
  • Updated from v2.0.1 to v2.0.3 (#3134)
• Templates:
  • Updated to the latest revisions (#3134)

Full changes: https://github.com/lima-vm/lima/milestone/54?closed=1
Thanks to @afbjorklund @alexandear @jandubois @nirs @olamilekan000 @paulinek13

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/12899702091

The sha256sum of the SHA256SUMS file itself is 05b809c6e23fa411fd6987c4fab1ceccb8efda36241130cc5269ba746a2a7762 .

---

Release manager: @AkihiroSuda

v1.0.3

Changes

• QEMU:
  • Support Apple M4 (#3032)
• gRPC port forwarder:
  • Improvements on stability (#2971, #2985, etc. thanks to @nirs @balajiv113)
• Templates:
  • archlinux: allow 9p again (#3048)
  • centos-stream-10: New template (#3023, #3047, thanks to @afbjorklund)
  • opensuse: disable virtiofs due to the lack of the kernel module in the default installation (#3056)
  • Updated to the latest revisions (#3043)

Full changes: https://github.com/lima-vm/lima/milestone/52?closed=1
Thanks to @PascalBourdier @afbjorklund @alexandear @balajiv113 @cpick @jandubois @nirs @olamilekan000

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/12517401436

The sha256sum of the SHA256SUMS file itself is 69423d9f9044fc9264925d24cd38c1d0efb4367cfb46c568313f53d6f0ed7ee2 .

---

Release manager: @AkihiroSuda

v1.0.2

Changes

• DNS:

  • Fixed the host resolver regression in v1.0.0 #2939 (#2964)

• limactl create:

  • Fixed races during parallel downloads (#2903, thanks to @nirs)
  • Optimized qcow2-to-raw conversion for vz mode (#2933, thanks to @nirs)

• limactl start-at-login:

  • Fixed the support for Linux hosts (systemd) (#2943, thanks to @kachick)

• nerdctl:

  • Updated to v2.0.1 (#2966)

• Templates:

  • Updated to the latest revisions (#2936 #2953, thanks to @tcooper)

• Web site:

  • Added an example of running Lima on GitHub Actions to run commands on non-Ubuntu (#2954): https://lima-vm.io/docs/examples/gha/

• Project:

  • Invite Nir Soffer (@nirs) as a Reviewer (#2916, thanks to @jandubois)

Full changes: https://github.com/lima-vm/lima/milestone/51?closed=1
Thanks to @SpiffyEight77 @alexandear @jandubois @kachick @nirs @norio-nomura @tamird @tcooper

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/12134682585

The sha256sum of the SHA256SUMS file itself is 02ef78494c498ca4180915ba78d5e2fc471ed401f63dfb2b5864c3711f3c0fb2 .

---

Release manager: @AkihiroSuda

v1.0.1

Reverted the default port forwarder from gRPC to SSH for the stability reason (#2864).
This reversion fixes several regressions related to docker run -p in Lima v1.0.0 (#2859).

Although the gRPC forwarder is faster and has an advanced feature (UDP support), it turned out to be still immature.
Set LIMA_SSH_PORT_FORWARDER=false to opt-in to the gRPC forwarder.
See https://lima-vm.io/docs/config/port/.

Full changes: https://github.com/lima-vm/lima/milestone/50?closed=1
Thanks to @alexandear @jandubois @norio-nomura

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/11735352652

The sha256sum of the SHA256SUMS file itself is f5c12d003e25dc46291803a8acae9e9d325a45eca0c1f9f40bd6852ec8ed9be1 .

---

Release manager: @AkihiroSuda

v1.0.0

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 (#2758)
  • 🔴 Use VZ by default for new instances on macOS >= 13.5 (#1951)
  • Support nested virtualization on M3 (#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 (#2562, thanks to @norio-nomura)

• QEMU:

  • Graduate 9p mount driver from experimental (#2758)
  • 🔴 Use 9p by default for most templates (#1953, #2822)
  • riscv64: switch from u-boot to EDK2 (#2592)

• Network:

  • Graduate user-v2 network driver from experimental (#2758)
  • Support UDP port forwarding (#2411, thanks to @balajiv113)
  • 🔴 Strictly require socket_vmnet binary to be owned by root (#2734)

• SSH:

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

• YAML:

  • Support generating jsonschema (#2306, thanks to @afbjorklund)
  • Support specifying param for provisioning scripts (#2570, thanks to @jandubois)
  • Support specifying minimumLimaVersion and vmOpts.qemu.minimumVersion (#2659, thanks to @jandubois)
  • Support template expansion in mounts (#2588, thanks to @norio-nomura)

• limactl CLI:

  • Add limactl tunnel command so as to allow the host to join the guest network (#2710)
  • Add --log-format=json (#2584, thanks to @nirs)
  • limactl prune: Add --keep-referred (#2569, thanks to @norio-nomura)

• nerdctl:

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

• Templates:

  • 🔴 experimental/vz: Merged into the default template (#2730, #2736)
  • 🟡 experimental/{riscv64, armv7l}: Merged into the default template (#2730, #2736)
  • 🔴 vmnet: Removed in favor of limactl create --network=lima:shared template://default (#2736)
  • 🟡 experimental/net-user-v2: Removed in favor of limactl create --network=lima:user-v2 template://default (#2736)
  • 🔴 experimental/9p: Removed in favor of limactl create --mount-type=9p template://default (#2736)
  • 🟡 experimental/virtiofs-linux: Removed in favor of limactl create --mount-type=virtiofs template://default (#2736)
  • 🔴 alpine: Renamed to alpine-iso (#2704)
  • 🔴 alpine-image: Renamed to alpine (#2704)
  • archlinux: Demoted from Tier 1 to Tier 2 (#2717, #2823)
  • default, ubuntu, ...: Updated to Ubuntu 24.10. The older versions are available as ubuntu-20.04, ubuntu-22.04, and ubuntu-24.04 (#2755, #2795)
  • fedora: Updated to Fedora 41 (#2821, #2822, thanks to @subpop)
  • opensuse: Renamed to opensuse-leap. Still aliased as opensuse (#2612, thanks to @afbjorklund)
  • experimental/opensuse-tumbleweed: Support aarch64 (#2613, thanks to @afbjorklund)
  • hack/update-template.sh is added for automating updates (#1347, thanks to @norio-nomura)

• Project:

  • 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

v1.0.0-beta.0

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

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 (#2758)
  • 🔴 Use VZ by default for new instances on macOS >= 13.5 (#1951)
  • Support nested virtualization on M3 (#2530, thanks to @abiosoft)
  • Optimize image conversion (lima-vm/go-qcow2reader#31 , lima-vm/go-qcow2reader#34 , thanks to @nirs)
  • Support specifying a custom kernel (#2562, thanks to @norio-nomura)

• QEMU:

  • Graduate 9p mount driver from experimental (#2758)
  • 🔴 Use 9p by default (#1953)
  • riscv64: switch from u-boot to EDK2 (#2592)

• Network:

  • Graduate user-v2 network driver from experimental (#2758)
  • Support UDP port forwarding (#2411, thanks to @balajiv113)
  • 🔴 Strictly require socket_vmnet binary to be owned by root (#2734)

• SSH:

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

• YAML:

  • Support generating jsonschema (#2306, thanks to @afbjorklund)
  • Support specifying PARAM (#2570, thanks to @jandubois)
  • Support template expansion in mounts (#2588, thanks to @norio-nomura)

• limactl CLI:

  • Add --log-format=json (#2584, thanks to @nirs)
  • limactl prune: Add --keep-referred (#2569, thanks to @norio-nomura)

• nerdctl:

  • rootless: allocate 1G subuids from 524288 (0x80000) for new users (#2725)

• Templates:

  • 🔴 experimental/vz: Merged into the default template (#2730, #2736)
  • 🟡 experimental/{riscv64, armv7l}: Merged into the default template (#2730, #2736)
  • 🔴 vmnet: Removed in favor of limactl create --network=lima:shared template://default (#2736)
  • 🟡 experimental/net-user-v2: Removed in favor of limactl create --network=lima:user-v2 template://default (#2736)
  • 🔴 experimental/9p: Removed in favor of limactl create --mount-type=9p template://default (#2736)
  • 🟡 experimental/virtiofs-linux: Removed in favor of limactl create --mount-type=virtiofs template://default (#2736)
  • 🔴 alpine: renamed to alpine-iso (#2704)
  • 🔴 alpine-image: renamed to alpine (#2704)
  • archlinux: Demoted from Tier 1 (#2717)
  • opensuse: Renamed to opensuse-leap (#2612, thanks to @afbjorklund)
  • experimental/opensuse-tumbleweed: Support aarch64 (#2613, thanks to @afbjorklund)

• Project:

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

Full changes: https://github.com/lima-vm/lima/milestone/47?closed=1
Thanks to @AdamKorcz @SmartManoj @YorikSar @abiosoft @afbjorklund @alexandear @balajiv113 @hasan4791 @jandubois @nirs @norio-nomura @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/11430109582

The sha256sum of the SHA256SUMS file itself is 85671aa3701b7b206af26ecd5a2e5a30dca3aa2d9dce9f35a5f58a6fcfad5779 .

---

Release manager: @AkihiroSuda

v1.0.0-alpha.0

Changes

• vz:
  • Use VZ by default for new instances on macOS >= 13.5 (#1951)

Full changes: https://github.com/lima-vm/lima/milestone/47?closed=1

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/10628063124

The sha256sum of the SHA256SUMS file itself is 69bbfccf7e046e03edd5d3facd8bf699f8276ee91dd1c2e50ecd97fd7ed36def .

---

Release manager: @AkihiroSuda

v0.23.2

Changes

• Network:

  • Fixed a stability issue (#2556, #2561)

• Templates:

  • Updated to the latest revisions (#2556)

Full changes: https://github.com/lima-vm/lima/milestone/49?closed=1

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/10610584784

The sha256sum of the SHA256SUMS file itself is 9183a5703205d331d89f4a62abdbbb377cb77f1f49f8171cfa722960d7174bf1 .

---

Release manager: @AkihiroSuda

v0.23.1

Changes

• Fixed the CI to generate the release note (#2555)

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/10441930092

The sha256sum of the SHA256SUMS file itself is e93a48f3a011c25367da50ab3609bb28437fcde259371f005f8b234caa46efff .

---

Release manager: @AkihiroSuda

v0.23.0

• YAML:

  • Add a param field for defining variables (#2498, thanks to @norio-nomura)

• vz:

  • Prioritize rosetta over qemu-user-static (#2474, thanks to @norio-nomura)
  • Configura AOT caching options using an abstract socket (#2489, thanks to @norio-nomura)

• Templates:

  • add alpine-image (#2360, thanks to @jandubois)
  • remove centos-stream-8, deprecated/centos-7 (#2457)
  • update to the latest revisions (#2553)

• Governance:

  • MAINTAINERS: invite Oleksandr Redko (@alexandear) as a Reviewer (#2383)

Full changes: https://github.com/lima-vm/lima/milestone/46?closed=1
Thanks to @AdamKorcz @AmedeeBulle @SmartManoj @afbjorklund @alexandear @danchr @fwilhe2 @jandubois @norio-nomura @tcooper @why168