NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules, #140 by repository stars
Latest stable
v1.2.3
Last release 11 months ago
23 Dec 2025
Release timing varies
gaps range from 8 days to 4 months
Nearly every release is documented
notes for 58 of 58 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
255 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
This release introduces several breaking changes, such as switching the default machine driver from QEMU to VZ for better filesystem performance.
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:
QEMU:
Network:
socket_vmnet binary to be owned by root (#2734)SSH:
ssh.loadDotSSHPubKeys by default (#2706)YAML:
param for provisioning scripts (#2570, thanks to @jandubois)minimumLimaVersion and vmOpts.qemu.minimumVersion (#2659, thanks to @jandubois)limactl CLI:
limactl tunnel command so as to allow the host to join the guest network (#2710)--log-format=json (#2584, thanks to @nirs)limactl prune: Add --keep-referred (#2569, thanks to @norio-nomura)nerdctl:
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:
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
[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
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
This release introduces several breaking changes, such as switching the default machine driver from QEMU to VZ for better filesystem performance.
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:
QEMU:
Network:
socket_vmnet binary to be owned by root (#2734)SSH:
ssh.loadDotSSHPubKeys by default (#2706)YAML:
PARAM (#2570, thanks to @jandubois)limactl CLI:
--log-format=json (#2584, thanks to @nirs)limactl prune: Add --keep-referred (#2569, thanks to @norio-nomura)nerdctl:
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:
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
[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
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Use VZ by default for new instances on macOS >= 13.5
Full changes: https://github.com/lima-vm/lima/milestone/47?closed=1
[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
Fixed a stability issue (#2556, #2561)
Network:
Templates:
Full changes: https://github.com/lima-vm/lima/milestone/49?closed=1
[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
Nothing published for this version
Fixed the CI to generate the release note
[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
Nothing published for this version
remove centos-stream-8, deprecated/centos-7
YAML:
param field for defining variables (#2498, thanks to @norio-nomura)vz:
Templates:
alpine-image (#2360, thanks to @jandubois)centos-stream-8, deprecated/centos-7 (#2457)Governance:
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
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
This release drops the support for vde_vmnet (deprecated since 2022) in favor of `socket_vmnet`.
This release drops the support for vde_vmnet (deprecated since 2022) in favor of socket_vmnet.
vmnet users will need to regenerate the /etc/sudoers.d/lima file:
limactl sudoers >etc_sudoers.d_lima
sudo install -o root etc_sudoers.d_lima /etc/sudoers.d/lima
Users may also want to clean up the vde-related lines from their ~/.lima/_config/networks.yaml:
--- /Users/user/.lima/_config/networks.yaml.bak 2024-05-07 14:17:28
+++ /Users/user/.lima/_config/networks.yaml 2024-05-07 14:18:09
@@ -13,9 +13,6 @@
# socketVMNet requires Lima >= 0.12 .
# socketVMNet has precedence over vdeVMNet.
socketVMNet: "/opt/socket_vmnet/bin/socket_vmnet"
-# vdeSwitch and vdeVMNet are DEPRECATED.
- vdeSwitch: /opt/vde/bin/vde_switch
- vdeVMNet: /opt/vde/bin/vde_vmnet
varRun: /private/var/run/lima
sudoers: /private/etc/sudoers.d/lima
vmnet:
vde_vmnet (Deprecated since Sep 2022, in favor of socket_vmnet) (#2311)limactl CLI:
limactl ls $INSTANCE now exits with non-zero status if the instance does not exist (#2295, thanks to @BajuMcBites)nerdctl:
Misc:
Templates:
Full changes: https://github.com/lima-vm/lima/milestone/45?closed=1
Thanks to @BajuMcBites @afbjorklund @alexandear @jandubois @vasileknik76
[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/8980002249
The sha256sum of the SHA256SUMS file itself is ae6c43a8f145d574142deb1c6e105e4ab79156947b9098bf57c94d91ff15da97 .
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
This release adds the support for limactl start-at-login and inotify.
This release adds the support for limactl start-at-login and inotify.
limactl CLI:
limactl start-at-login INSTANCE command (#2151, thanks to @roman-kiselenko)Mounts:
limactl start --mount-inotify (#1913, thanks to @balajiv113)YAML:
{{.Name}} in provision scripts (#2179)nerdctl:
Templates:
Full changes: https://github.com/lima-vm/lima/milestone/43?closed=1 Thanks to @afbjorklund @alexandear @balajiv113 @blmhemu @jandubois @norio-nomura @pendo324 @roman-kiselenko @terev
[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/8307250970
The sha256sum of the SHA256SUMS file itself is 3a4fc483678ef5aea033a9d19b5e4db1ddc480f54d1a12afb257f255d72b5395 .
Nothing published for this version
Add limactl start-at-login INSTANCE command (#2151, thanks to @roman-kiselenko)
limactl CLI:
limactl start-at-login INSTANCE command (#2151, thanks to @roman-kiselenko)Mounts:
limactl start --mount-inotify (#1913, thanks to @balajiv113)YAML:
{{.Name}} in provision scripts (#2179)Templates:
Full changes: https://github.com/lima-vm/lima/milestone/43?closed=1 Thanks to @afbjorklund @alexandear @balajiv113 @blmhemu @jandubois @norio-nomura @pendo324 @roman-kiselenko
[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/8245128886
The sha256sum of the SHA256SUMS file itself is a7d9e816923b4c027393d7eb37084288e8808807937a9d38fd13bea2e4367cf7 .
alpine: avoid wiping out writable host mounts under /home, etc
alpine: avoid wiping out writable host mounts under /home, etc (https://github.com/lima-vm/lima/pull/2244, thanks to @jandubois)Prior to Lima v0.20.2, a host directory could be wiped out when all the following conditions are met:
[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/8244166862
The sha256sum of the SHA256SUMS file itself is 1aa58b5567fb1e2ca60500ed0e8b7fefbdf930d74214b3858add6b20f5dbdec3 .
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Contains runc v1.1.12 (fixes CVE-2024-21626) and BuildKit v0.12.5 (CVE-2024-23650, CVE-2024-23651, CVE-2024-23652, CVE-2024-23653)
limactl CLI:
limactl --help (#2167, thanks to @ayushgml)QEMU:
nerdctl:
Templates:
Full changes: https://github.com/lima-vm/lima/milestone/42?closed=1 Thanks to @alexandear @ayushgml @jandubois @vasileknik76
[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/7734320742
The sha256sum of the SHA256SUMS file itself is 0714cba526d924e243865f5b3a6293e5d054af04fccd3642850839b0a15aa58b .
Nothing published for this version
This release adds the support for propagating the timezone from the host setting. This release also fixes incompatibility with Go 1.22 (ETA: February
This release adds the support for propagating the timezone from the host setting. This release also fixes incompatibility with Go 1.22 (ETA: February 2024).
Misc:
lima-version file in the instance directory (#2107, thanks to @jandubois)limactl CLI:
limactl start --foreground for better support of launchd (#2146, thanks to @norio-nomura)YAML:
upgradePackages: <bool> to upgrade the packages on boot (#2119, thanks to @afbjorklund)QEMU:
WSL2:
Templates:
alpine: Update Alpine to 3.19 (#2136, thanks to @jandubois)rke2: Update RKE2 to 1.29 (#2157)u7s: Update Usernetes to gen2-v20231218.0 (#2157)k8s: stop using sudo kubectl for KUBECONFIG (#2102, thanks to @afbjorklund)Full changes: https://github.com/lima-vm/lima/milestone/41?closed=1 Thanks to @DennisRasey @afbjorklund @alexandear @jandubois @mhumeSF @norio-nomura @pendo324 @porfirion @stefanb @zhaojizhuang
[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/7582028915
The sha256sum of the SHA256SUMS file itself is 09361987b9794963cfc4e6290842de8fbeafb8f075138178b0a7c42d85839b25 .
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
This release adds the support for QEMU v8.2.0 (ETA: Dec 19) and Apple M3.
This release adds the support for QEMU v8.2.0 (ETA: Dec 19) and Apple M3.
QEMU:
edk2-aarch64-code.fd (#2061, #2084).
As a side-effect, this is expected to fix an incompatibility with Apple M3 as well (#1996).lima-guestagent:
Boot scripts:
nerdctl:
Templates:
Full changes: https://github.com/lima-vm/lima/milestone/40?closed=1 Thanks to @alexandear @jandubois @mhio
[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/7249793232
The sha256sum of the SHA256SUMS file itself is 89a52004f9b9abe9bf5a4f618e3383a05619c279a337945603285c52ac04948b .
One column per quarter.