+11
Daily
+124
Weekly
+255
Monthly
22,363
stars
1,005
forks
88
watchers
3,697
prs
1,639
issues
106
releases
README
[[🌎Web site]](https://lima-vm.io/)
[[📖Documentation]](https://lima-vm.io/docs/)
[[👤Slack (lima)]](https://slack.cncf.io)
Lima: Linux Machines
Lima launches Linux virtual machines with automatic file sharing and port forwarding (similar to WSL2).
The original goal of Lima was to promote containerd including nerdctl (contaiNERD ctl)
to Mac users, but Lima can be used for non-container applications as well.
Lima also supports other container engines (Docker, Podman, Kubernetes, etc.) and non-macOS hosts (Linux, NetBSD, etc.).
Getting started
Set up (Homebrew):
bash
brew install lima
limactl start
If you are on Windows, Lima can be installed through PowerShell using:
powershell
winget install Lima.Lima
For other installation methods, see .
To run Linux commands:
bash
lima uname -a
To run containers with containerd:
bash
lima nerdctl run --rm hello-world
To run containers with Docker:
bash
limactl start template:docker
export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock')
docker run --rm hello-world
To run containers with Kubernetes:
bash
limactl start template:k8s
export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml')
kubectl apply -f ...
See for the further information.
Software Bill of Materials (SBOM)
The "sbom" download contains SBOM in the CycloneDX format since v2.3.
There are both "app" \.bom.json and "mod" bom.json files:
- SBOMs generated with "app" include only those modules that the target application
actually depends on. Modules required by tests or packages that are not imported
by the application are not included. Build constraints are evaluated, which enables
a very detailed view of what's really compiled into an application's binary.
- SBOMs generated with "mod" include the aggregate of modules required by all
packages in the target module. This optionally includes modules required by
tests and test packages. Build constraints are NOT evaluated, allowing for
a "whole picture" view on the target module's dependencies.
Contributing
We welcome contributions! Please see our Contributing Guide for details on:
- Developer Certificate of Origin (DCO): All commits must be signed off with git commit -s
- Code licensing and pull request guidelines
- Testing requirements
Community
Adopters
Container environments:
- Rancher Desktop: Kubernetes and container management to the desktop
- Colima: Docker (and Kubernetes) on macOS with minimal setup
- Finch: Finch is a command line client for local container development
- Podman Desktop: Podman Desktop GUI has a plug-in for Lima virtual machines
GUI:
- Lima xbar plugin: xbar plugin to start/stop VMs from the menu bar and see their running status.
- lima-gui: Qt GUI for Lima
Communication channels
- GitHub Discussions
- lima channel in the CNCF Slack
- New account:
- Login:
- Community meetings on Zoom (tentatively monthly)
- Meeting notes & agenda proposalsTop issues
#892FreeBSD Support (host)48 comments · 2022-06-08#1259shared network mode not working on Mac M135 comments · 2022-12-23#2lima+wayland35 comments · 2021-05-14#231chown/chmod on mounted directory: Permission denied28 comments · 2021-09-09#4053VirtioFS directory mapping wrong uid/gid on Darwin (docker rootful template)25 comments · 2025-09-18#503MacOS M1 Limactl start hangs on Waiting for essential requirement 3 of 5: sshfs binary to be installed (`Could not connect to 127.0.0.1:48100 (127.0.0.1). - connect (111: Connection refused)`)25 comments · 2021-12-30#1609vz: lima managed vm hangs with high CPU usage intermittently.22 comments · 2023-06-05#3592MacOS Rosetta broke on latest kernel Fedora 41 (rosetta error: unhandled auxillary vector type 29)20 comments · 2025-05-27
Discussions
#5764devvm: One VM for every project (Not my work)0 comments · 2026-11-08#5757v2.3.00 comments · 2026-11-06#5684HanaLima: Native macOS GUI for Lima with rootless NAT, host-only and bridged networks0 comments · 2026-10-26#56382026-11-10 (Tuesday) and 12 (Thursday) @ KubeCon (Salt Lake City)0 comments · 2026-10-16#55782026-10-15 (Thursday)2 comments · 2026-10-05#5569UniHarness: An agent harness that gives any LLM a computer to complete tasks the way humans do (Not my work)0 comments · 2026-10-03#5568Unuko 5G Core & RSP Simulation Suite (Not my work)0 comments · 2026-10-03#5567trailofbits/coop: Isolated VM environment for running Claude Code and Codex (Not my work)0 comments · 2026-10-03
Latest release
v2.3.0 v2.3.0 2026-11-06Highlights: - 🪟Experimentally support HCS driver for eliminating QEMU dependency (Windows hosts) - 🍎Attach host block devices to VZ guests (macOS hosts) - 🐧Experimentally support lima:shared, lima:host, and lima:bridged networks (Linux hosts) - 🖥️limactl menu: an experimental menu-based user interface Changes - Windows host support: - Experimentally support HCS driver (5449 5514, thanks to LFX mentee @mie313, and @unsuman) - Support native Windows OpenSSH (5298 5299 5300 5337, thanks to @jandubois) - Automatically append common tool directories (e.g., QEMU) to PATH (534