Home

Awesome

[🌎Web site] [📖Documentation] [👤Slack (#lima)]

<picture> <source media="(prefers-color-scheme: dark)" srcset="website/static/images/logo-dark.svg"> <img alt="Shows a stylized 'Lima' text in bold, modern font" src="website/static/images/logo.svg" width=400 /> </picture>

Lima: Linux Machines

OpenSSF Best Practices OpenSSF Scorecard

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 (on macOS):

brew install lima
limactl start

To run Linux commands:

lima sudo apt-get install -y neofetch
lima neofetch

To run containers with containerd:

lima nerdctl run --rm hello-world

To run containers with Docker:

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:

limactl start template://k8s
export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml')
kubectl apply -f ...

See https://lima-vm.io/docs/ for the further information.

Community

Adopters

Container environments:

GUI:

Communication channels

Code of Conduct

Lima follows the CNCF Code of Conduct.


We are a Cloud Native Computing Foundation sandbox project.

<picture> <source media="(prefers-color-scheme: dark)" srcset="https://www.cncf.io/wp-content/uploads/2022/07/cncf-white-logo.svg"> <img src="https://www.cncf.io/wp-content/uploads/2022/07/cncf-color-bg.svg" width=300 /> </picture>

The Linux Foundation® (TLF) has registered trademarks and uses trademarks. For a list of TLF trademarks, see Trademark Usage.