v0.19.1

This release adds the support for QEMU v8.2.0 (ETA: Dec 19) and Apple M3.

Changes

• QEMU:

  • Support QEMU v8.2.0 by bumping up 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:

  • Add logging for Alpine (#2065, thanks to @jandubois)

• Boot scripts:

  • Only terminate user connections when the environment changes (#2048, thanks to @mhio)

• nerdctl:

  • Update from v1.7.1 to v1.7.2 (#2063)

• Templates:

  • Arch Linux: update to 20231215.200192 (#2082)
  • CentOS Stream 8: update to 20231211.0 (#2063)
  • CentOS Stream 9: update to 20231211.0 (#2063)
  • Debian 12: update to 20231210-1591 (#2063)
  • Ubuntu 22.04: update to release-20231211 (#2063)

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

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

The sha256sum of the SHA256SUMS file itself is 89a52004f9b9abe9bf5a4f618e3383a05619c279a337945603285c52ac04948b .

v0.19.0

This release fixes the disk image corruption issue with --vm-type=vz on ARM Mac (#2026)

Changes

• limactl CLI:

  • Add limactl disk resize command (#2034, thanks to @vasileknik76)

• VZ:

  • Fix the disk image corruption issue on ARM Mac (#2026, thanks to @wpiekutowski for providing the hint)

• QEMU:

  • Skip checking the qemu binary signature on macOS 11 and older (#1981, thanks to @jandubois)

• Hostagent (affects port forwarding, reverse sshfs, etc.)

  • Increase the limit on the number of the file descriptors (#2015, thanks to @vasileknik76)

• Guestagent:

  • Switch away from SSH to vsock (vz) and virtio serial (qemu) (#1998, thanks to @balajiv113)

• Misc:

  • Fix SELinux issues (#1926, #1942, #1965, thanks to @hasan4791)

• nerdctl:

  • Update from v1.6.2→v1.7.0→v1.7.1 (#2044)

• Templates:

  • AlmaLinux, Rocky Linux, Oracle Linux: update to 9.3 and 8.9 (#2024, #2027, #2043, thanks to @tcooper)
  • Arch Linux: update to 20231115.191878
  • CentOS Stream 8: update to 20231127.0 (#2043)
  • CentOS Stream 9: update to 20231128.1 (#2043)
  • Debian 11, 12: update to 20231013-1532 (#2027)
  • Fedora: update to 39 (#1997, thanks to @ZhongRuoyu)
  • Ubuntu 22.04: update to release-20231026 (#2027)
  • Add template://experimental/gentoo (#1935, thanks to @afbjorklund)

Full changes: https://github.com/lima-vm/lima/milestone/39?closed=1
Thanks to @ZhongRuoyu @afbjorklund @alexandear @balajiv113 @choznerol @cwegener @hasan4791 @jandubois @neowu @takanohi @tcooper @terev @vasileknik76 @yuvipanda

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

The sha256sum of the SHA256SUMS file itself is 91cc6cfbae984339c1cd15ab861fd7c8054490ed7bb1d6622513d23e3a7cb454 .

v0.18.0

Highlights:

• wsl2 driver (experimental)
• limactl create --plain to create "plain" instances (no mounts, port forwarding, containerd, etc.)
• Significant updates on the website (https://lima-vm.io/)

Changes

• limactl CLI:

  • Move --set, --network, and --video out of experimental (#1852)
  • Make --tty to be a global flag (#1864)
  • Add limactl protect <INSTANCE> to prohibit accidental removal (#1873)
  • Deprecate limactl show-ssh in favor of ssh -F ... (#1811)

• YAML:

  • Add "plain" mode (disables mounts, port forwarding, containerd, etc.) (#1840)

• WSL2:

  • Add an experimental wsl2 driver (#1721, #1883, etc. Thanks to @pendo324)

• user-v2 network:

  • Support for configurable network addresses (#1626, #1886, thanks to @balajiv113)
  • Support for deterministic IP (#1801, thanks to @balajiv113)

• nerdctl:

  • Update from v1.5.0 to v1.6.0
    →v1.6.1
    →v1.6.2 (#1820, #1911, #1912)

• Templates:

  • Alpine: update to alpine-lima v0.2.32 (#1869)
  • Arch Linux: update to 20231001.182377 (#1911)
  • CentOS Stream 8: update to 20231009.1 (#1911)
  • CentOS Stream 9: update to 20231009.1 (#1911)
  • Debian 11: update to 20231004-1523 (#1911)
  • Debian 12: update to 20231004-1523 (#1911)
  • Ubuntu 22.04: update to release-20231010 (#1911)
  • Ubuntu 23.04: update to 23.10 (#1911)
  • Add template://experimental/vnc with Xorg (#1901, thanks to @afbjorklund)

• Makefile:

  • Add make menuconfig (#1790, thanks to @afbjorklund)

• Web site:

  • https://lima-vm.io/ is now significantly updated (#1754, etc., thanks to @balajiv113)

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

Thanks to @AlexVCS @Victor-Chris @afbjorklund @balajiv113 @cdfmlr @jandubois @lobshunter @mairin @ningziwen @pendo324 @pszpetkowski @reishoku

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

The sha256sum of the SHA256SUMS file itself is 17404ec5525140772889134715239de966cd507b7d96a733f49bca40ee54e4ce .

v0.18.0-beta.0

v0.18.0-beta.0

(Changes to be documented)

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

The sha256sum of the SHA256SUMS file itself is 9eff4d6ad78985452c456050b49237ad774be38969b11820b9a04f041aa30e01 .

v0.17.2

On macOS hosts, Lima now asks the user to sign the QEMU binary with the com.apple.security.hypervisor entitlement if the binary is not properly signed:

$ limactl start
INFO[0000] Using the existing instance "default"        
WARN[0000] QEMU binary "/usr/local/bin/qemu-system-x86_64" is not properly signed with the "com.apple.security.hypervisor" entitlement  error="failed to run [codesign --verify /usr/local/bin/qemu-system-x86_64]: exit status 1 (out=\"/usr/local/bin/qemu-system-x86_64: invalid signature (code or signature have been modified)\\nIn architecture: x86_64\\n\")"
? Try to sign "/usr/local/bin/qemu-system-x86_64" with the "com.apple.security.hypervisor" entitlement? (Y/n)
...

Choose Y to sign the binary.

This signing is usually not needed on users' side.
However, the Homebrew bottle of QEMU v8.0.4 needs this signing due to a temporary issue of Homebrew's build infrastructure:

• #1742

The Homebrew bottle of QEMU v8.0.3 is not affected by this issue.

Changes

QEMU:

• Ask to sign QEMU binary when the binary is not properly signed (#1743)

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

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

The sha256sum of the SHA256SUMS file itself is 006f022e19d2b03869c33ee30be694217937d8c774af7b9714e2d7659da31aa5 .

v0.17.1

This release fixes incompatibility with Go 1.21 (#1729).

Changes

Misc:

• Support Go 1.21 (#1729)

Apptainer:

• apptainer.lima: Use APPTAINER_BINDPATH instead of APPTAINER_HOME (#1716, thanks to @afbjorklund)

Templates:

• Remove nomad, as Nomad is no longer free software (#1728)
• Update CentOS Stream 9 to 20230807.1 (#1730)
• Update Debian 11 and 12 to 20230802-1460 (#1730)
• Update Ubuntu 23.04 to release-20230810 (#1730)

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

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

The sha256sum of the SHA256SUMS file itself is eb92c7f2bf0d3ed9787ac5130860900e09573c3ec7568bde151025038186b59e .

v0.17.0

This release adds the limactl create command.
Now it is discouraged (not deprecated) to use limactl start for creating new instances.

Discouraged form:

limactl start --name=foo template://docker

Recommended form:

limactl create --name=foo template://docker
limactl start foo

The limactl create command also takes several flags like --cpus=1 --memory=2 --vm-type=vz --mount-writable=true for modifying the template.
Some of these flags are similar to the flags of colima start.

Changes

• limactl CLI:

  • Add limactl create (#1643, #1677).
  • Add --cpus, --memory, --mount-type, --vm-type, ..., --video (#1468, #1696, #1709)

• YAML:

  • Adjust the default CPUs and memory size depending on the host capacity (#1603)
  • Allow leaving additional disks unformatted (#1516, thanks to @afbjorklund)

• VZ:

  • Remove dependency on qemu-img binary for converting qcow2 to raw (#1507)
  • Enable virtiofs by default when vmType == vz (#1613)
  • Support video display (#1597, #1602, thanks to @balajiv113)

• QEMU:

  • Connect a virtio-serial device to serialv.log in the instance directory (#1674, #1693)
  • Connect a pci-serial device to serialp.log for making more boot logs visible on ARM (#1703)
  • Support virtiofs on Linux hosts (#1628, thanks to @refi64).
    macOS hosts still require VZ for using virtiofs.
  • Support armv7l (32-bit ARM) architecture (#1633)

• nerdctl:

  • Update from v1.4.0 to v1.5.0 (#1700)

• Templates:

  • CentOS Stream 8: update to 20230710.0 (#1700)
  • CentOS Stream 9: update to 20230720.0 (#1700)
  • Debian: update to 12 (#1635, #1700, thanks to @unidevel)
  • Oracle Linux: update to 8.8 and 9.2 (#1700)
  • Ubuntu: update to release-20230729 (#1700)
  • openSUSE: update to 15.5 (#1700)
  • Add template://experimental/rke2 (#1650, thanks to @Hirozy)
  • Promote template://docker to Tier 1 (#1694)

• Misc:

  • Makefile: add make minimal (#1673)
  • Rename "examples" to "templates" (#1679, #1707)

Full changes: https://github.com/lima-vm/lima/milestone/35?closed=1
Thanks to @ArmingLou @Hirozy @afbjorklund @a-palchikov @balajiv113 @fyuan1316 @jandubois @refi64 @unidevel

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

The sha256sum of the SHA256SUMS file itself is 17389cba1ccc7429968fddea3427d85eddc1f37eaa3a57f3750c3552f661c4ed .

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 .