v0.16.0

This release adds an experimental support for the user-v2 network driver: limactl start template://experimental/net-user-v2.
The user-v2 network driver enables VM-to-VM networking without the root privilege on the host.
This should be useful for simulating multi-node Kubernetes clusters on a laptop.

This release also fixes a relatively minor vulnerability CVE-2023-32684.
This vulnerability is very unlikely to be exploitable as long as you are using the official templates of Lima.

Changes

• limactl CLI:
  • (Experimental) Add limactl snapshot (apply|create|delete|list) commands (#1054, thanks to @afbjorklund)
  • Escape only the value of env variables in limactl shell (#1501, thanks to @sam-berning)
• YAML:
  • Add "dependency" provisioning mode (#1105, thanks to @pendo324)
  • (Experimental) Add .audio.device (#1527, #1532, #1561, #1589, thanks to @afbjorklund @balajiv113)
• Documents:
  • Install man pages (#1521, thanks to @afbjorklund)
• Network:
  • (Experimental) Add user-v2 network driver to enable VM-to-VM networking without root (#1383, thanks to @balajiv113)
• nerdctl:
  • Update from v1.3.1 to v1.4.0 (#1559)
• Templates:
  • AlmaLinux: update to 9.2 (#1550)
  • Alpine: update to 3.18 and fix Rosetta support (#1560, #1580, thanks to @jandubois)
  • Arch Linux: update to 20230515.150700 (#1550)
  • Fedora: update to 38 (#1502, thanks to @cpach)
  • Nomad: update to v0.9.4 (#1552)
  • Rocky Linux: update to 9.2 and 8.8 (#1550, #1591)
  • Ubuntu: update to 23.04 (#1550)
• Misc:
  • Improve disk efficiency (#1411) for caches (#1544)

Full changes: https://github.com/lima-vm/lima/milestone/34?closed=1
Thanks to @afbjorklund @balajiv113 @bumpsoo063 @cpach @jandubois @pendo324 @sam-berning

Usage

[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/5118006806

The sha256sum of the SHA256SUMS file itself is 2062c42688128dca55331fc1a8f4841cbf41ed9dd11867d48decdf6880afde87 .

v0.15.1

This release adds support for QEMU 8.0.

Changes

• limactl CLI:
  • Improve the argument error message (#1391, thanks to @lobshunter)
  • Improve the "failed to download" error message (#1465)
  • Add --log-level flag (#1308, thanks to @afbjorklund)
  • limactl edit: add --set <YQ EXPRESSION> (#1412, thanks to @afbjorklund)
• YAML:
  • Allow rosetta fields to be overridden (#1413, thanks to @pendo324)
  • Support specifying compressed images (*.gz, *.bz2, *.xz, *.zst) (#1439, thanks to @afbjorklund)
• QEMU:
  • Fix broken state on QEMU ACPI shutdown (#1397, thanks to @balajiv113)
  • Disable pdppe1gb on Intel Mac, for supporting QEMU 8.0 (#1487)
• VZ:
  • Support mounting additional disks (#1405, thanks to @pendo324)
  • Fix panic during limactl stop (#1494, #1497, thanks to @balajiv113)
• nerdctl:
  • update from v1.2.1 to v1.3.1. (#1460, #1486) thanks to @ningziwen)
    Change logs: https://github.com/containerd/nerdctl/releases/tag/v1.3.0 https://github.com/containerd/nerdctl/releases/tag/v1.3.1
• Templates:
  • Alpine: setup apk cache on persistent volume (#1471, thanks to @jandubois)
  • Arch Linux: update to 20230415.143207 (#1498)
  • CentOS Stream 8: update to 20230404.0 (#1498)
  • CentOS Stream 9: update to 20230410.0 (#1498)
  • Ubuntu 22.04: update to release-20230302 (#1498)
  • Ubuntu 22.10: update to release-20230413 (#1498)
  • openSUSE: support aarch64 (#1450, #1462, thanks to @e-minguez)

Full changes: https://github.com/lima-vm/lima/milestone/33?closed=1
Thanks to @afbjorklund @balajiv113 @e-minguez @jandubois @lobshunter @ningziwen @pendo324

Usage

[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/4709036669

The sha256sum of the SHA256SUMS file itself is 91cb421f8488916b6e7ae387446c21c86e4e972bda32a7e377eee58508699911 .

v0.15.0

This release experimentally implements yq expressions for customizing the templates (#1359),
e.g.,

limactl start --set='.cpus = 2 | .memory = "2GiB"'

This release is also remarkable for automatic forwarding of Kubernetes NodePorts and LoadBalancers (#1355).

Also, in this release we welcome new maintainers Anders F Björklund (@afbjorklund) and Balaji Vijayakumar (@balajiv113) 🎉

Upgrading notice

containerd <= v1.6.16 creates /etc/cni with permission 0700 when running in the rootful mode.

This causes an error like open /etc/cni/tuning/allowlist.conf: permission denied for CNI tuning plugin >= v1.2.0 when running in the rootless mode.

Lima users may face this error during upgrading nerdctl to >= v1.2.0 (Lima >= v0.15.0).
Run lima sudo chmod 0755 /etc/cni to dismiss this error.

Changes

• limactl CLI

  • limactl start: Experimentally add limactl start --set <YQ EXPRESSION>: to customize the template (#1359, thanks to @afbjorklund).
    e.g., limactl start --set='.cpus = 2 | .memory = "2GiB"'
  • limactl list: Dynamically hide columns depending on the terminal width (#1266, thanks to @afbjorklund)

• YAML:

  • Add .copyToHost for copying files from the guest to the host (#1301, thanks to @afbjorklund)
  • Add .video.vnc for experimental VNC support (#1004, thanks to @afbjorklund)

• SSH:

  • Write ~/.lima/<INSTANCE>/ssh.config. The file can be passed to ssh -F. (#1326)

• QEMU:

  • Experimentally support VNC video display (#1004, thanks to @afbjorklund)
  • Fix binding multiple disks in M1 (#1332, thanks to @balajiv113)

• VZ:

  • Fix disk image corruption (#1315, thanks to @balajiv113)

• Kubernetes:

  • Support automatically forwarding Kubernets NodePorts and LoadBalancers (#1355, thanks to @lobshunter)
  • Add kubectl.lima script for wrapping kubectl (#1302, thanks to @afbjorklund)

• DNS:

  • Return NODATA for IPv6 AAAA queries (#1289, thanks to @Nino-K)
  • Don't log DNS queries by default (#1368, thanks to @jandubois)

• nerdctl:

  • update from v1.1.0 to v1.2.1 (#1388). Change logs: https://github.com/containerd/nerdctl/releases/tag/v1.2.0 https://github.com/containerd/nerdctl/releases/tag/v1.2.1

• Templates:

  • Alpine: update to alpine-lima 0.2.27 (#1369)
  • Arch Linux: update to 20230215.126932 (#1388)
  • CentOS Stream 9: update to 20230216.0 (#1388)
  • Debian 11: update to 20230124-1270 (#1388)
  • Rocky Linux 8.7: update to 20230215.0 (#1388)
  • Rocky Linux 9.1: update to 20230215.0 (#1388)
  • Ubuntu 22.04: update to 20230210 (#1388
  • Ubuntu 22.10: update to 20230215 (#1388)
  • openSUSE Tumbleweed: remove aarch64 image due to 404 (#1388)

• Project:

  • MAINTAINERS: add Anders F Björklund (@afbjorklund) and Balaji Vijayakumar (@balajiv113) (#1323)

Full changes: https://github.com/lima-vm/lima/milestone/30?closed=1
Thanks to @Nino-K @afbjorklund @balajiv113 @deitch @jandubois @lobshunter @pnasrat @ryancurrah @suyanhanx

Usage

[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/4292802059

The sha256sum of the SHA256SUMS file itself is 50c50e8ab02b0187b2d795b191834bfcaa66757c6abbaa708be6a13658495d48 .

v0.14.2

Changes

• VZ:

  • Fix NSInvalidArgumentException on headless hosts, such as EC2 mac2.metal (#1261)

• limactl CLI:

  • limactl start: support reading template from stdin (limactl start --name=NAME --tty=false -) (#1250, thanks to @deitch)
  • limactl info: add vmTypes []string to the JSON output (#1262)

• Templates:

  • Arch Linux: update to 20221215.111177 (#1257)

Full changes: https://github.com/lima-vm/lima/milestone/32?closed=1
Thanks to @deitch

Usage

[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/3766201229

The sha256sum of the SHA256SUMS file itself is 682c7d5e520914cc513d8af440de9ea3608817bbb475a45e893e238b7d14d0af .

v0.14.1

This release fixes a regression #1242 in Lima v0.14.0:
On colima, docker data, such as containers and images in /var/lib/docker were unmounted and they looked as if they were removed.

The actual data are not removed, and can be rescued by upgrading Lima to this v0.14.1 release (or downgrading to v0.13.0).

Only the following instances are known to have been affected:

• colima instances
• alpine instances that were created with Lima before v0.13.0

The default (ubuntu) instances are unaffected.

Changes

• Boot scripts:
  • Check if growpart is installed before calling it (#1243, thanks to @jandubois)
• VZ:
  • Fix nil pointer deference (#1245)
  • Validate disk format (#1245)
• Templates:
  • Alma Linux 9: fix 404 (#1244)
• Website:
  • Set up https://lima-vm.io/ (#1240)

Full changes: https://github.com/lima-vm/lima/milestone/31?closed=1
Thanks to @hftsin @jandubois

Usage

[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/3692334791

The sha256sum of the SHA256SUMS file itself is 11c0e020d62d8192e40249c9aa978f7dc15ea6e250aa8d66879045812b807d02 .

v0.14.0

This release adds an experimental support for Apple's Virtualization.framework aka vz.

limactl start template://experimental/vz

Pros:

• Supports faster filesystem sharing (virtiofs)
• Supports faster emulation for running Linux/x86_64 ELF binaries on ARM (Rosetta 2)

Cons:

• No support for legacy BIOS
• The boot log is not available in serial.log
• The source code of Virtualization.framework does not seem available

Using Virtualization.framework with Lima needs macOS 13.0 or later.
See also docs/vmtype.md.

Changes

• Virtualization.framework (VZ):

  • Support Virtualization.framework (#1147, etc., thanks to @balajiv113)
  • Support Rosetta for Linux (#1155, thanks to @chancez)
  • Support vzNAT networking (#1207)

• vmnet:

  • Support detecting Homebrew's socket_vmnet path (#1220)

• YAML:

  • Remove deprecated network and useHostResolver (#1186)

• limactl CLI:

  • Allow using $SSH as a custom SSH binary path (#1132, thanks to @antoineco)
  • Add limactl disk (create|delete|list) commands for attaching multiple disks to instances (#1065, thanks to @sam-berning)
  • Add limactl start --timeout=<TIMEOUT> for setting custom timeout (#1143, thanks to @antoineco)

• nerdctl:

  • Update to v1.1.0. Compose is significantly improved. (#1236)

• Templates: (#1159, #1194, #1215, #1236)

  • Alpine: update to 3.17.0
  • Arch Linux: update to 20221201.106936
  • Debian 11: update to 20221205-1220
  • EL derivatives: update to 8.7/9.1
  • Fedora: update to 37
  • Ubuntu 22.04: update to release-20221201
  • Ubuntu 22.10: update to release-20221201
  • openSUSE Tumbleweed: switch away from "JeOS" to "Minimal-VM"

• Misc:

  • Add Finch as an adopter of Lima (#1199, thanks to @estesp)

Full changes: https://github.com/lima-vm/lima/milestone/29?closed=1
Thanks to @afbjorklund @antoineco @balajiv113 @chancez @chrisx8 @estesp @jandubois @pendo324 @sam-berning

Usage

[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/3676969854

The sha256sum of the SHA256SUMS file itself is adcc4b9c798aba356c5c3a5140a77edf8443b8df9e195d7ba89d976ef5074ed3 .

v0.14.0-beta.1

This release adds an experimental support for Apple's Virtualization.framework aka vz.

limactl start template://experimental/vz

Pros:

• Supports faster filesystem sharing (virtiofs)
• Supports faster emulation for running Linux/x86_64 ELF binaries on ARM (Rosetta 2)

Cons:

• No support for legacy BIOS
• The boot log is not available in serial.log
• The source code of Virtualization.framework does not seem available

Using Virtualization.framework with Lima needs macOS 13.0 or later.

Changes

(To be documented)
Since beta.0, the support for Rosetta was added.

Full changes: https://github.com/lima-vm/lima/milestone/29?closed=1
Thanks to @afbjorklund @antoineco @balajiv113 @chancez @chrisx8 @jandubois @pendo324 @sam-berning

Usage

[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/3531739770

The sha256sum of the SHA256SUMS file itself is daebd6289f6327f70abd14616747e906244cd3f5665b5662e93242d9b6368732 .

v0.14.0-beta.0

This release adds an experimental support for Apple's Virtualization.framework aka vz.

limactl start template://experimental/vz

Pros:

• Supports faster filesystem sharing (virtiofs)
• (Coming soon) Supports faster emulation for running Linux/x86_64 ELF binaries on ARM (Rosetta 2)

Cons:

• No support for legacy BIOS
• The boot log is not available in serial.log
• The source code of Virtualization.framework does not seem available

Using Virtualization.framework with Lima needs macOS 13.0 or later.

Changes

(To be documented)

Full changes: https://github.com/lima-vm/lima/milestone/29?closed=1
Thanks to @antoineco @balajiv113 @chrisx8 @jandubois @pendo324 @sam-berning

Usage

[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/3477558407

The sha256sum of the SHA256SUMS file itself is 4ab2fc1128fed870a4803f1c12ebdfc58357584dc25fa31ae2547efb72c13b37 .

v0.13.0

Lima is now a CNCF Sandbox project 🎉

The slack is now moved to the #lima channel in the CNCF Slack.

• New account: https://slack.cncf.io/
• Login: https://cloud-native.slack.com/

Changes

• nerdctl:

  • Update from v0.23.0 to v1.0.0 (#1127)

• YAML:

  • Add "boot" provisioning script mode (#1094, thanks to @pendo324)

• QEMU:

  • Enable trimming QEMU disks (#1102, thanks to @chrisx8)
  • Change the default securityModel of 9p (experimental) from mapped-xattr to none, for supporting symlinks, sacrificing the support for chown (#1110)

• Templates:

  • alpine: update alpine-lima to 0.2.23, to include resize2fs and growpart (#1106, #1118, thanks to @jandubois)
  • archlinux: update update Arch Linux to 20221015.94571 (#1127)
  • debian: update Debian 11 to 20221020-1174 (#1127)
  • default, ubuntu, etc.: update Ubuntu from 22.04 to 22.10 (#1127)
  • experimental/{almalinux,centos-stream,oraclinux,rocky}-9: moved to almalinux, centos-stream, oraclelinux, rocky (#1120)
  • k8s: Update flannel from v0.19.1 to v0.20.0 (#1128, thanks to @afbjorklund)
  • podman-rootful: add podman-rootful (#1052, thanks to @afbjorklund)
  • singularity, experimental/apptainer: moved to apptainer (#1076, #1081, thanks to @afbjorklund)
  • ubuntu-lts: update Ubuntu 22.04 to release-20221018 (#1127)

• Project:

  • Lima is now a CNCF Sandbox project (#1061, #1064)

Full changes: https://github.com/lima-vm/lima/milestone/28?closed=1
Thanks to @Nino-K @afbjorklund @chrisx8 @jandubois @pendo324 @saltbo @vmasutin

Usage

[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/3322258374

The sha256sum of the SHA256SUMS file itself is b13864b41c85112c51f24f9de41f4a4d1d7c8b1f4b56da5630484bbdfeb0c1bd .

v0.12.0

This release adds support for socket_vmnet and deprecates vde_vmnet.

Mode	Shared (NAT)	Bridged
socket_vmnet	0.66 Gbps	1.23 Gbps
vde_vmnet	0.27 Gbps	0.31 Gbps

The next major release will be probably v1.0 🎉 , and the default mount driver will be changed from reverse-sshfs to 9p: #971 .
(EDIT: this will probably happen after the release of QEMU 7.2: #971 (comment))

---

Changes

• nerdctl:

  • Update from v0.22.2 to v0.23.0. Features nerdctl compose run, etc. (#1047)

• Network:

  • Support socket_vmnet; deprecate vde_vmnet (#851)

• YAML:

  • Deprecate non-strict YAML (https://github.com/lima-vm/lima/issues/1045)


• Templates:

  • alpine: update alpine-lima to v0.2.21 (#1047)
  • archlinux: update Arch Linux to v20220901.79699 (#1047)
  • debian: update Debian 11 to release 20220816-1109 (#1047)
  • default, ubuntu, ...: Update Ubuntu 22.04 to release 20220902 (#1047)
  • docker-rootful: Add docker-rootful (#1025)
  • k8s: Bug fixes (#1035, #1037, thanks to @afbjorklund)
  • experimental/opensuse-tumbleweed: Support aarch64 (#1014, thanks to @replicajune)

Full changes: https://github.com/lima-vm/lima/milestone/27?closed=1
Thanks to @afbjorklund @replicajune

Usage

[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/3040193685

The sha256sum of the SHA256SUMS file itself is 5f7accbeca07867c51b024f377177d64aef9fb5ead7f1260d62da60374e030da .