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 .

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 .