lima README

The project's README from github.com/lima-vm/lima. As one markdown file: README.md.

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

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):

brew install lima
limactl start

To run Linux commands:

lima uname -a

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.

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: https://slack.cncf.io/
- Login: https://cloud-native.slack.com/
Community meetings on Zoom (tentatively monthly)
- Meeting notes & agenda proposals: https://github.com/lima-vm/lima/discussions/categories/meetings
- Calendar: https://zoom-lfx.platform.linuxfoundation.org/meetings/lima

Follow us for project updates, release announcements, and community news:

Code of Conduct

Lima follows the CNCF Code of Conduct.

We are a Cloud Native Computing Foundation incubating project.

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

Searching Database…

22.1K ·GitHub

这是什么东西?

Lima 可以启动 Linux 虚拟机,自动完成文件共享和端口转发,类似 WSL2。它最初是为了让 Mac 用户也能用上 containerd 和 nerdctl 而创建的,但并不局限于容器用途。

Lima 是图形界面应用,还是要在终端里操作?

它是一个命令行工具:通过 limactl 命令行管理虚拟机,然后在你自己的终端里操作 Linux。没有图形界面。

怎么安装,怎么启动第一台虚拟机?

用 Homebrew 安装(brew install lima),然后用 limactl start 创建并启动一台虚拟机。之后就可以直接运行 Linux 命令或容器了。

在 Lima 虚拟机里可以运行哪些容器引擎?

containerd 是内置的默认选项,Lima 还支持 Docker、Podman 和 Kubernetes,你可以继续用自己熟悉的引擎。

它只能在 Mac 上运行,还是也能在其他主机上用?

macOS 是最初的目标平台,不过 Lima 也能在其他主机上运行,包括 Linux 和 NetBSD。

nerdctl 是什么?

它是 contaiNERD ctl,也就是 containerd 的命令行客户端——正是 Lima 围绕打造的那个容器工具。

这个项目还在积极维护吗,还是只是个业余实验?

它已经相当成熟:在 GitHub 上有约 22,000 颗星,2021 年 5 月启动,目前仍在积极开发中(没有被归档)。

What are similar projects?

vfkit, colima, smolvm, qemu, nerdctl, podman, ProxmoxVE, containerd

Which topics is it in?

containerd, qemu, vm, virtual-machine, virtualization, containers, homebrew, kubernetes, devops, go, command-line-tool, apache-2.0

Creator: lima-vm
Size: 18.9 MB
Stars: 22.1K
Updated: CommitOct 18 Releasev2.2.1Oct 03
Age: 5y
Commits · 90 Days