lima-vm

Overview

Lima (Linux Machines) is a Linux virtual machine manager for macOS, designed to deliver a WSL2-like user experience on macOS through automatic file sharing, network port forwarding, and simplified configuration. Initially developed to promote containerd and nerdctl on macOS, Lima also supports running other container engines (such as Docker, Podman, Kubernetes) as well as non-containerized Linux applications and workloads. Additionally, Lima can run on other non-macOS hosts, including Linux and NetBSD.

Key Features

1. Simplified Linux VM Management

• Use the command-line tool limactl to quickly create, start, stop, and manage multiple Linux VM instances.
• Supports various pre-defined templates (e.g., docker, k8s) to deploy pre-configured containerized environments with a single command.
• VM configuration is based on YAML files, enabling easy customization and version control.

2. Seamless File Sharing

• Automatically mounts macOS user directories (e.g., $HOME) into the VM, enabling bidirectional file access between host and VM.
• Supports custom mount points for convenient project file sharing.

3. Automatic Port Forwarding

• Similar to WSL2, automatically configures networking so applications running in the VM can be accessed directly via host ports.
• Supports manual port mapping configurations for scenarios requiring network access, such as web services or databases.

4. Multi-Container Engine Support

• Built-in containerd and nerdctl: Lima natively supports the containerd runtime and its CLI tool, nerdctl.
• Docker Support: Launch a VM pre-installed with Docker using limactl start template://docker, and connect your local Docker client by setting the DOCKER_HOST environment variable.
• Kubernetes Support: Provides a k8s template to quickly set up a single-node Kubernetes cluster, with KUBECONFIG automatically configured.
• Podman Support: Podman can also be used as the container engine.

5. Cross-Platform Compatibility

• While primarily targeted at macOS users, Lima can also run on Linux, NetBSD, and other operating systems, ensuring consistent experience across hosts.

6. Community and Ecosystem Integration

• Adopted by popular desktop container management tools such as Rancher Desktop, Colima, Finch, and Podman Desktop.
• Offers graphical helper tools, such as the Lima xbar plugin, enabling quick VM start/stop and status checks directly from the macOS menu bar.

Core Advantages

🚀 Ready-to-Use Container Development Experience

For macOS developers working with containers, Lima significantly streamlines the workflow for building and testing Linux containers locally. No complex Docker Desktop setup or third-party VM software is required—just a few commands to get a fully functional Linux container environment up and running.

🔧 Flexibility and Choice

Lima is not tied to a single container technology stack. Users can flexibly choose between containerd, Docker, or Kubernetes based on project needs, and even run multiple VMs with different configurations on the same host.

📚 Declarative Configuration and Version Control

All VM configurations (CPU, memory, mounts, networking, etc.) are stored in YAML files, making them ideal for Git management, team collaboration, and reproducible environments.

🛡 Lightweight and Focused

Compared to full desktop-grade virtual machines, Lima focuses on delivering a lightweight, optimized Linux environment tailored for command-line and container workloads—resulting in lower resource usage and faster startup times.

🌉 Excellent Host Integration

Automatic file sharing and port forwarding eliminate barriers between host and VM, making it feel as if developers are running Linux commands and containers directly on their local machine, thereby improving development efficiency.

Getting Started

Install Lima using Homebrew:

brew install lima

Start a default Lima VM:

limactl start

Run Linux commands in the VM:

lima uname -a

Start a VM with Docker:

limactl start template://docker
export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock')
docker run --rm hello-world

Start a single-node Kubernetes cluster:

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

Learn More

• Community Discussion: Join the conversation on Slack in the #lima channel.

Lima is an active open-source project. Developers are welcome to contribute by submitting Issues and Pull Requests. All contributions must comply with the project’s Developer Certificate of Origin (DCO) requirements.