Akihiro Suda
02eafe9cfe
Press `c` or F7 in the instance list (or "Create Instance" in the empty state) to open a form for the instance name, template, CPUs, memory, disk, VM type, and whether to start the instance after creation. Empty fields fall back to the template defaults. The other `limactl create` flags (mounts, networks, port forwards, `--set`, `--param`, etc.) are available in the "Details" section, which is hidden by default. Its fields are generated from the flag definitions of `limactl create`, and the description of the focused field is shown below the form. To minimize free-text input, the values are chosen from dropdowns whenever the choices are known: the shell completion values of the flags, the drivers, and the image variants of the selected template. "Other..." in a dropdown allows entering a value that is not in the list. "Create" runs `limactl start` (or `limactl create`) with the corresponding flags. "Edit" opens an editor for the template YAML with the form values applied, and then creates the instance from the edited YAML. In both cases, the menu is suspended while limactl is running, and the new instance is selected when returning to the menu. The form can be navigated with the arrow keys as well as with Tab: Up/Down move between the fields and the buttons (except in an open dropdown list, and except between the lines of a text area), and Left/Right move between the buttons. The single-key shortcuts of the instance list are now only handled while the list has the focus, so that they do not interfere with typing into the form. Fixes #5595 Assisted-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
[🌎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.
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
#limachannel 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
Social media accounts
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.