base on Linux virtual machines, with a focus on running containers [[🌎**Web site**]](https://lima-vm.io/) [[📖**Documentation**]](https://lima-vm.io/docs/) [[👤**Slack (`#lima`)**]](https://slack.cncf.io) <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 [](https://deepwiki.com/lima-vm/lima) [](https://www.bestpractices.dev/projects/6505) [](https://scorecard.dev/viewer/?uri=github.com/lima-vm/lima) [Lima](https://lima-vm.io/) launches Linux virtual machines with automatic file sharing and port forwarding (similar to WSL2). The original goal of Lima was to promote [containerd](https://containerd.io) including [nerdctl (contaiNERD ctl)](https://github.com/containerd/nerdctl) 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 ``` 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 <https://lima-vm.io/docs/> for the further information. ## Contributing We welcome contributions! Please see our [Contributing Guide](https://lima-vm.io/docs/community/contributing/) 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](https://rancherdesktop.io/): Kubernetes and container management to the desktop - [Colima](https://github.com/abiosoft/colima): Docker (and Kubernetes) on macOS with minimal setup - [Finch](https://github.com/runfinch/finch): Finch is a command line client for local container development - [Podman Desktop](https://podman-desktop.io/): Podman Desktop GUI has a plug-in for Lima virtual machines GUI: - [Lima xbar plugin](https://github.com/unixorn/lima-xbar-plugin): [xbar](https://xbarapp.com/) plugin to start/stop VMs from the menu bar and see their running status. - [lima-gui](https://github.com/afbjorklund/lima-gui): Qt GUI for Lima ### Communication channels <!-- Duplicated from https://lima-vm.io/docs/community/ --> - [GitHub Discussions](https://github.com/lima-vm/lima/discussions) - `#lima` channel in the CNCF Slack - New account: <https://slack.cncf.io/> - Login: <https://cloud-native.slack.com/> - Zoom meetings (tentatively monthly) - Meeting notes & agenda proposals: https://github.com/lima-vm/lima/discussions/categories/meetings - Calendar: https://zoom-lfx.platform.linuxfoundation.org/meetings/lima ### Social media accounts Follow us for project updates, release announcements, and community news: - https://x.com/@TheLimaProject - https://mastodon.social/@TheLimaProject ### Code of Conduct Lima follows the [CNCF Code of Conduct](https://github.com/cncf/foundation/blob/main/code-of-conduct.md). - - - **We are a [Cloud Native Computing Foundation](https://cncf.io/) incubating 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](https://www.linuxfoundation.org/legal/trademark-usage). ", Assign "at most 3 tags" to the expected json: {"id":"3779","tags":[]} "only from the tags list I provide: []" returns me the "expected json"