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 10 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
252 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
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
This release introduces an experimental support for AlmaLinux 9 and CentOS Stream 9.
This release introduces an experimental support for AlmaLinux 9 and CentOS Stream 9.
nerdctl:
nerdctl compose up. (#910)YAML:
.[]mounts.mountPoint to support specifying a custom mount point (#867, thanks to @chancez).ssh.forwardX11 and .ssh.forwardX11Trusted to allow X11 forwarding (#877, thanks to @jordemort)limactl CLI:
Templates
alpine: Update to alpine-lima v0.2.17 (Alpine Linux 3.16) (#910)archlinux: Update to ArchLinux 20220615.61815 (#910)centos-stream: Add centos-stream (CentOS Stream 8-20220125.1) (#901, thanks to @afbjorklund)opensuse: Update to openSUSE Leap 15.4 (#890)oraclelinux: Update to Oracle Linux 8.6; support ARM (#865)podman: Change the VM distro from Ubuntu 22.04 (Podman 3) to Fedora 36 (Podman 4) (#876, thanks to @dmage)experimental/almalinux-9: Add experimental/almalinux-9 (AlmaLinux 9.0)(#904)experimental/apptainer: Add experimental/apptainer (Apptainer 1.0.2 on Rocky Linux 8.5) (#887, thanks to @afbjorklund)experimental/centos-stream-9: Add experimental/centos-stream-9 (CentOS Stream 9-20220606.0) (#901, thanks to @afbjorklund)Full changes: https://github.com/lima-vm/lima/milestone/23?closed=1
Thanks to @afbjorklund @chancez @davebarkerxyz @dmage @jandubois @jordemort @nl6720 @nunix
[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/2522953157
The sha256sum of the SHA256SUMS file itself is 6b52aedb4eb30332e740ad834add7ee871c03fccc8427ffc9a7e10efce7c8222 .
Nothing published for this version
Nothing published for this version
Nothing published for this version
This release adds an experimental support for RISC-V (#827): limactl start template://experimental/riscv64
This release adds an experimental support for RISC-V (#827): limactl start template://experimental/riscv64
QEMU:
limactl start template://experimental/riscv64$HOME/.local/share/qemu (#820, thanks to @jcdickinson)Network:
nerdctl:
nerdctl builder debug command for interactive debugging of Dockerfile.
https://github.com/containerd/nerdctl/blob/v0.20.0/docs/builder-debug.mdTemplates:
almalinux: Update to AlmaLinux 8.6 (#860)alpine: Update to Alpine-Lima 0.2.13 (#860)archlinux: Update to 20220515.56564 (#860)fedora, singularity: Update to Fedora 36 (#854)k8s: Support Kubernetes 1.24 (#846, 818, thanks to @afbjorklund)docker: Add the docker.lima wrapper, similar to the nerdctl.lima wrapper (#855, thanks to @afbjorklund)podman: Add the podman.lima wrapper, similar to the nerdctl.lima wrapper (#855, thanks to @afbjorklund)Full changes: https://github.com/lima-vm/lima/milestone/22?closed=1
Thanks to @afbjorklund @jandubois @jcdickinson
brew install lima
https://github.com/Homebrew/homebrew-core/commit/e21a16e2d982fb5070c5f671891e667e4cb5d0d4
[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/2350148772
The sha256sum of the SHA256SUMS file itself is a10530d36673adc0952df64ffaf333ae573fc8cc658e66215fd940073290ec12 .
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 experimental support for 9P to replace reverse-sshfs mounts: ` limactl start --name=default template://experimental/9p `
This release adds experimental support for 9P to replace reverse-sshfs mounts:
limactl start --name=default template://experimental/9p
Adoption of 9P is aimed at solving the issues around stability and security of reverse-sshfs. The default mount type is still reverse-sshfs, but the default is planned to be changed to 9P in Lima v1.0.
Mounts:
sftpDriver: "openssh-sftp-server" to replace the "builtin" SFTP implementation (#804)QEMU:
nerdctl:
nerdctl cp.limactl CLI:
limactl shell: add --shell option (#779, #780, thanks to @jandubois)limactl start: template://: support subdirectories (#805)YAML:
.caCerts (#783, thanks to @nickpetrovic)Templates:
Full changes: https://github.com/lima-vm/lima/milestone/21?closed=1 Thanks to @afbjorklund @jandubois @nickpetrovic @tdaniely-dn @tweltz @xfoxfu
brew install lima
https://github.com/Homebrew/homebrew-core/commit/8bcf04872a089a0d9a7979d479b116ad8fb46d23
[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/2218559760
The sha256sum of the SHA256SUMS file itself is 6fc5182eb4498660ccb5a69e42af126ee665c72bb5e6c8a604c6cfa8257b490d .
Nothing published for this version
Nothing published for this version
Add `deprecated/centos-7.yaml`. This example is already deprecated on its birth. Users are suggest to use rocky.yaml or almalinux.yaml. (#720, thanks…
:warning: Running recent Linux guests on M1 macOS needs Homebrew's QEMU 6.2.0_1 or later.
Run brew upgrade to upgrade QEMU.
Intel macOS users are NOT affected by this issue.
For the further information, see https://github.com/lima-vm/lima/pull/734 and https://github.com/Homebrew/homebrew-core/pull/96743 .
nerdctl
nerdctl build can consume local images in FROM ... lines of Dockerfile.limactl CLI:
factory-reset command (#757, thanks to @Junnplus)Network:
Examples:
archlinux.yaml now supports aarch64 (ARM) architecture (#750, thanks to @mcginty)deprecated/centos-7.yaml. This example is already deprecated on its birth. Users are suggest to use rocky.yaml or almalinux.yaml. (#720, thanks to @alisson276)Full changes: https://github.com/lima-vm/lima/milestone/20?closed=1 Thanks to @Junnplus @alisson276 @jandubois @mcginty
brew install lima
https://github.com/Homebrew/homebrew-core/commit/eeb646b9e232c7d98c81229b6ea8491ae1fc8ccf
[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/2044479172
The sha256sum of the SHA256SUMS file itself is 5acfb83e93363ee5b9085d0e90ba5a7923e00629a0bc25234758b428f6bb94dd .
Nothing published for this version
Nothing published for this version
Nothing published for this version
:warning: Running recent Linux guests on M1 macOS needs Homebrew's QEMU 6.2.0_1 or later. Run `brew upgrade` to upgrade QEMU. Intel macOS users are NO
:warning: Running recent Linux guests on M1 macOS needs Homebrew's QEMU 6.2.0_1 or later.
Run brew upgrade to upgrade QEMU.
Intel macOS users are NOT affected by this issue.
For the further information, see https://github.com/lima-vm/lima/pull/734 and https://github.com/Homebrew/homebrew-core/pull/96743 .
QEMU:
Project:
Other changes: https://github.com/lima-vm/lima/milestone/19?closed=1 Thanks to @Junnplus @jandubois
brew install Lima
https://github.com/Homebrew/homebrew-core/commit/22a62843249edc0010f6627a52a8784d8e4ac5d4
[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/1979479375
The sha256sum of the SHA256SUMS file itself is 6bc15d1e275dc2cf156579a6e65d8f5d217d57b7c5528be8959b779f14c87f40 .
:warning: Running recent Linux guests on M1 macOS needs Homebrew's QEMU 6.2.0_1 or later. Run `brew upgrade` to upgrade QEMU. Intel macOS users are NO
:warning: Running recent Linux guests on M1 macOS needs Homebrew's QEMU 6.2.0_1 or later.
Run brew upgrade to upgrade QEMU.
Intel macOS users are NOT affected by this issue.
For the further information, see https://github.com/lima-vm/lima/pull/734 and https://github.com/Homebrew/homebrew-core/pull/96743 .
nerdctl:
limactl CLI:
limactl start template://TEMPLATE (#674), e.g., limactl start --name=default template://docker. The template can be also chosen from TUI.$ limactl start
? Creating an instance "default" [Use arrows to move, type to filter]
Proceed with the current configuration
Open an editor to review or modify the current configuration
> Choose another example (docker, podman, archlinux, fedora, ...)
Exit
? Choose an example [Use arrows to move, type to filter]
> almalinux
alpine
archlinux
debian
default
docker
faasd
...
buildkit.yaml (#653, thanks to @developer-guy)oraclelinux.yaml (#700, thanks to @chrisperelstein)Other changes: https://github.com/lima-vm/lima/milestone/18?closed=1 Thanks to @chrisperelstein @developer-guy @deviantintegral @jandubois @jwhb @samuelkarp
brew install lima
https://github.com/Homebrew/homebrew-core/commit/dfb16b662187d68a8c1b20b4f8f998d54601ae80
[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/1967583891
The sha256sum of the SHA256SUMS file itself is a10848bd3bfa41b395ca54473bc82fe59081cc4e0b11f7b6c7c35a18ba633374 .
(Changes to be documented) https://github.com/lima-vm/lima/milestone/18?closed=1
(Changes to be documented) https://github.com/lima-vm/lima/milestone/18?closed=1
[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/1962700739
The sha256sum of the SHA256SUMS file itself is b54c393705a6e69d25bda4c3672fff25caaf8eee8a71bd0ec85394a0ec25939b .
Nothing published for this version
> Note: Upgrading lima does not automatically upgrade nerdctl in the existing instances.
Note: Upgrading
limadoes not automatically upgradenerdctlin the existing instances. To upgradenerdctl, recreate a new Lima instance, or replace/usr/local/bin/nerdctlbinaries in the existing instance manually:
- https://github.com/containerd/nerdctl/releases/download/v0.17.0/nerdctl-0.17.0-linux-amd64.tar.gz (Intel)
- https://github.com/containerd/nerdctl/releases/download/v0.17.0/nerdctl-0.17.0-linux-arm64.tar.gz (ARM)
Network:
portForwards.guestIPMustBeZero property to support docker run -p 0.0.0.0:... (#660, thanks to @jandubois)SSH:
QEMU:
cpuType, e.g., Haswell-v4 (#643, #656, #662, thanks to @Junnplus and @jandubois)Examples:
almalinux.yaml (#630, thanks to @reishoku)podman.yaml: use connection instead of $CONTAINER_HOST (#644, thanks to @afbjorklund)default.yaml, alpine.yaml, archlinux.yaml, debian.yaml, fedora.yaml, opensuse.yaml, vmnet.yaml .Translation:
README.md: README.ja.md (#621, thanks to @reishoku)Other changes: https://github.com/lima-vm/lima/milestone/17?closed=1 Thanks to @Junnplus @afbjorklund @buu700 @jandubois @reishoku
brew install lima
https://github.com/Homebrew/homebrew-core/commit/5e7bcfac005f9264e180aea4877685d8546bd210
[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/1862709672
The sha256sum of the SHA256SUMS file itself is 1cabbfd9ab382296d9eeecdf26c25f0a1901b27ce288687a97fdd4929029a3ee .
Nothing published for this version
Nothing published for this version
Update to v0.16.1 (#619). Fixes several nerdctl login regressions.
nerdctl login regressions.Note: Upgrading
limadoes not automatically upgradenerdctlin the existing instances. To upgradenerdctl, recreate a new Lima instance, or replace/usr/local/bin/nerdctlbinaries in the existing instance manually:
- https://github.com/containerd/nerdctl/releases/download/v0.16.1/nerdctl-0.16.1-linux-amd64.tar.gz (Intel)
- https://github.com/containerd/nerdctl/releases/download/v0.16.1/nerdctl-0.16.1-linux-arm64.tar.gz (ARM)
SSHFS:
Network:
limactl CLI:
limactl edit command to edit the YAML (#572, thanks to @Junnplus)limactl start messages for copypastability (#595)Examples:
ubuntu-lts.yaml (#613, thanks to @reishoku). Same as ubuntu.yaml but pinned to the LTS version.Other changes: https://github.com/lima-vm/lima/milestone/16?closed=1 Thanks to @Junnplus @afbjorklund @developer-guy @ericpromislow @jandubois @jsoref @reishoku
brew install lima
https://github.com/Homebrew/homebrew-core/commit/4e19a277c7e38798d9b41fa723fd69f0feabcfad
[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/1776154960
The sha256sum of the SHA256SUMS file itself is b6438973dbc201edb3581a7ce01beb5320f87f3d8998e951945d9a6c05f1e02d .
Nothing published for this version
Automatically sync hwclock (#490, thanks to @mikluko)
nerdctl: update to v0.16.0 (#548)
Guest agent:
SSHFS:
.[]mounts.sshfs.followSymlinks to be true) (#495, thanks to @byepolr)Network:
QEMU:
Examples:
examples/k8s.yaml (#513, #522, #534, #536, thanks to @afbjorklund)examples/debian.yaml (#520, thanks to @reishoku).ssh.localPort in examples (#517, thanks to @jandubois)Other changes: https://github.com/lima-vm/lima/milestone/15?closed=1 Thanks to @afbjorklund @ain @byepolr @gayanper @jandubois @mikluko @reishoku @rfay
brew install lima
https://github.com/Homebrew/homebrew-core/commit/a302dcbe5ca6c35d3271cf4b09b96894ceafe677
[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/1691505802
The sha256sum of the SHA256SUMS file itself is 4b4b3ebb6899127cc2736b224d041d8b7338260a72e5750b034e67b4733f8af4 .
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Support global default.yaml and override.yaml (#436, thanks to @jandubois)
nerdctl: Update to v0.15.0 (#479)
YAML:
default.yaml and override.yaml (#436, thanks to @jandubois)message field to show custom messages to the user (#472, thanks to @afbjorklund)$ limactl start /usr/local/share/doc/lima/examples/docker.yaml
...
INFO[0122] READY. Run `limactl shell docker` to open the shell.
INFO[0122] To run `docker` on the host (assumes docker-cli is installed):
INFO[0122] $ export DOCKER_HOST=unix:///Users/foo/.lima/docker/sock/docker.sock
INFO[0122] $ docker ...
Shell:
$COLORTERM to the lima shell environment (#435, thanks to @afbjorklund)Examples:
examples/centos.yaml with examples/rocky.yaml (#448)examples/faasd.yaml (#441, thanks to @jsiebens)Other changes: https://github.com/lima-vm/lima/milestone/14?closed=1 Thanks to @afbjorklund @jandubois @jsiebens @k-nasa
brew install lima
https://github.com/Homebrew/homebrew-core/commit/6215fc04fb7cb281817ec0ea4b56bc70b22150e2
[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/1577781065
The sha256sum of the SHA256SUMS file itself is 21265455c39aa16924c5013ae97ebdc0055180eb3d6e27eb53c436b0b144456a .
Nothing published for this version
Nothing published for this version
Nothing published for this version
nerdctl: Update to v0.14.0, and install bash completion (#426).
nerdctl: Update to v0.14.0, and install bash completion (#426).
limactl list:
--list-fields option (#324, thanks to @afbjorklund)limactl info: add $LIMA_HOME (#400, thanks to @jandubois)
Support old OpenSSH (#382, #386, thanks to @davidcassany)
Other changes: https://github.com/lima-vm/lima/milestone/13?closed=1 Thanks to @afbjorklund @davidcassany @efx @enihsyou @jandubois
brew install lima
https://github.com/Homebrew/homebrew-core/commit/32c4bfcfa010be36914523398c81b47815ece79a
[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/1490146744
The sha256sum of the SHA256SUMS file itself is f3dcd06328b571c8762a9c38315f8b842b6862af8754d77415ae2bd015c3f0ea .
Nothing published for this version
Nothing published for this version
This release introduces support for running Intel containers on ARM and vice versa, with nerdctl v0.13. Also provides better integration for Docker an
This release introduces support for running Intel containers on ARM and vice versa, with nerdctl v0.13. Also provides better integration for Docker and Podman.
nerdctl: Update to v0.13.0 (#379).
Key features: Multi-platform mode, nerdctl image encrypt, Kubernetes-aware nerdctl ps, zsh completion
Support forwarding sockets like docker.sock and podman.sock.
See examples/docker.yaml and examples/podman.yaml. (#369, thanks to @jandubois)
Fix propagation env vars like http_proxy (#362, #365, thanks to @jandubois)
examples/alpine.yaml: Support ARM (#373 , thanks to @jandubois)
examples/fedora.yaml: Update to Fedora 35 (#372)
examples/docker.yaml: Update to Ubuntu 21.10 (#364)
Other changes: https://github.com/lima-vm/lima/milestone/12?closed=1
brew install lima
https://github.com/Homebrew/homebrew-core/commit/2e161f3d4aa4afef4f2b8b18035cdc305463d28a
[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/1421099650
The sha256sum of the SHA256SUMS file itself is fb3c3667f5a493f4bee73b40d1bd153f439f2bfd328bc6ff714962fd0ea31e01 .
Nothing published for this version
Nothing published for this version
Bump up the default image from Ubuntu 21.04 to 21.10
limactl show-ssh --format=(cmd|args|options|config) INSTANCE (#338)HTTP_PROXY=http://localhost:<PORT> with HTTP_PROXY=http://<HOSTIP>:<PORT> automatically (#351, thanks to @jandubois)limactl list: show more details (#308, thanks to @afbjorklund)centos.yaml:CentOS 8 (#348, #345, #347 thanks to @afbjorklund)k8s.yaml: Kubernetes with kubeadm (#339, thanks to @afbjorklund)nomad.yaml: Nomad (#352, thanks to @afbjorklund)Other changes: https://github.com/lima-vm/lima/milestone/11?closed=1 Thanks to @afbjorklund @dee-kryvenko @jandubois @znz
brew install lima
https://github.com/Homebrew/homebrew-core/commit/04872584099052160c3fff6406ab7ddb64ca31ff
[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/1371055240
The sha256sum of the SHA256SUMS file itself is 4472ceca7d107f948613ec05f6e7edcb08c7f13cd458ec170530fafecc4d0907 .
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
Fixed the binary release pipeline (#305, #306). No change on the source code since v0.7.0.
Fixed the binary release pipeline (#305, #306). No change on the source code since v0.7.0.
brew install lima
https://github.com/Homebrew/homebrew-core/commit/1763395a7a06f8000c744b4482214fc52698f862
[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/1320119887
The sha256sum of the SHA256SUMS file itself is 65ad99d1558b97e12cf9eebdcc4cb8b7d6a85fc79b6bb94ac4fbe63f925d62c4 .
Nothing published for this version
Nothing published for this version
port: Enable sudo nerdctl run to expose ports to localhost (#242, thanks to @mattfarina)
sudo nerdctl run to expose ports to localhost (#242, thanks to @mattfarina)ssh.localPort automatically to an available port (#285)limactl cp now supports recursive copy (limactl cp -r) (#274, thanks to @HappyTobi)nerdctl build)limactl completion zsh, and make nerdctl.lima completion works (#234, thanks to @robberphex)Other changes: https://github.com/lima-vm/lima/milestone/5?closed=1 Thanks to @robberphex @mattfarina @jandubois @unixorn @ocadaruma @stealthyV1per @Nipsuli @afbjorklund @HappyTobi @hypnoce
[macOS]$ limactl start
...
INFO[0029] READY. Run `lima` to open the shell.
[macOS]$ lima uname
Linux
Binaries are not available for Lima v0.7.0, due to a bug in the release pipeline (https://github.com/lima-vm/lima/issues/304) 😅 . Fixed in v0.7.1.
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.