v0.22.0

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

Changes

• vmnet:

  • Remove the support for 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:

  • Update to v1.7.6 (#2304)

• Misc:

  • Drop support for Go 1.20 (#2258)

• Templates:

  • Ubuntu: update to 24.04 (#2300)
  • Fedora: update to 40 (#2292)
  • Update Alpine, Arch Linux, CentOS Stream, and Debian to the latest revisions (#2299, #2308, #2318 thanks to @jandubois)

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

Thanks to @BajuMcBites @afbjorklund @alexandear @jandubois @vasileknik76

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

The sha256sum of the SHA256SUMS file itself is ae6c43a8f145d574142deb1c6e105e4ab79156947b9098bf57c94d91ff15da97 .

v0.21.0

This release adds the support for limactl start-at-login and inotify.

Changes

• limactl CLI:

  • Add limactl start-at-login INSTANCE command (#2151, thanks to @roman-kiselenko)

• Mounts:

  • Support for inotify: limactl start --mount-inotify (#1913, thanks to @balajiv113)

• YAML:

  • Allow {{.Name}} in provision scripts (#2179)

• nerdctl:

  • Update to v1.7.4 → v1.7.5 (#2251)

• Templates:

  • Alpine: demote from Tier 1 to Tier 2 (#2236)
  • Update Ubuntu, Arch Linux, CentOS Stream, and Debian to the latest revisions (#2248)

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

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

The sha256sum of the SHA256SUMS file itself is 3a4fc483678ef5aea033a9d19b5e4db1ddc480f54d1a12afb257f255d72b5395 .

v0.21.0-beta.0

Changes

• limactl CLI:

  • Add limactl start-at-login INSTANCE command (#2151, thanks to @roman-kiselenko)

• Mounts:

  • Support for inotify: limactl start --mount-inotify (#1913, thanks to @balajiv113)

• YAML:

  • Allow {{.Name}} in provision scripts (#2179)

• Templates:

  • Alpine: demote from Tier 1 to Tier 2 (#2236)

Full changes: https://github.com/lima-vm/lima/milestone/43?closed=1
Thanks to @afbjorklund @alexandear @balajiv113 @blmhemu @jandubois @norio-nomura @pendo324
@roman-kiselenko

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

The sha256sum of the SHA256SUMS file itself is a7d9e816923b4c027393d7eb37084288e8808807937a9d38fd13bea2e4367cf7 .

v0.20.2

Changes

• alpine: avoid wiping out writable host mounts under /home, etc (#2244, thanks to @jandubois)

Prior to Lima v0.20.2, a host directory could be wiped out when all the following conditions are met:

• The directory is mounted to Lima via virtiofs or 9p (reverse-sshfs is not affected)
• The mount is writable
• The mount point in the guest is under one of: /etc /home /root /usr/local /var/lib
• The guest OS is Alpine Linux

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

The sha256sum of the SHA256SUMS file itself is 1aa58b5567fb1e2ca60500ed0e8b7fefbdf930d74214b3858add6b20f5dbdec3 .

v0.20.1

Changes

• limactl CLI:

  • Improve readability of limactl --help (#2167, thanks to @ayushgml)

• QEMU:

  • Unfork EDK2 (#2170). Now QEMU instances running on ARM Mac need QEMU >= 8.2.1 or QEMU < 8.2.0.

• nerdctl:

  • Update from v1.7.2 to v1.7.3 (#2172)
    • 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)

• Templates:

  • Update Ubuntu and CentOS Stream to the latest revision (#2172)

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

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

The sha256sum of the SHA256SUMS file itself is 0714cba526d924e243865f5b3a6293e5d054af04fccd3642850839b0a15aa58b .

v0.20.0

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).

Changes

• Misc:

  • Set guest timezone from host setting (#2097)
  • Support Go 1.22 (#2137)
  • Store lima-version file in the instance directory (#2107, thanks to @jandubois)

• limactl CLI:

  • Add limactl start --foreground for better support of launchd (#2146, thanks to @norio-nomura)

• YAML:

  • Add upgradePackages: <bool> to upgrade the packages on boot (#2119, thanks to @afbjorklund)

• QEMU:

  • Revert virtserialport back to unix socket for QEMU guest agent communication (#2112, thanks to @jandubois)
  • Support Debian trixie hosts' UEFI firmware path (#2124, thanks to @DennisRasey)

• WSL2:

  • Support guest agent (#2118, thanks to @pendo324)

• 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)
  • Update Ubuntu, CentOS Stream, Debian, Arch Linux to the latest revision (#2157)

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

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

The sha256sum of the SHA256SUMS file itself is 09361987b9794963cfc4e6290842de8fbeafb8f075138178b0a7c42d85839b25 .

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 .