explaingit

lima-vm/lima

📈 Trending★ 21,035GoAudience · developerComplexity · 3/5ActiveLicenseSetup · moderate

TLDR

Run Linux VMs on Mac with automatic file sharing and port forwarding, designed for container tools but works for any Linux workload.

Mindmap

mindmap
  root((Lima))
    What it does
      Linux VMs on Mac
      File sharing
      Port forwarding
    Supported runtimes
      containerd
      Docker
      Podman
      Kubernetes
    Getting started
      brew install
      limactl start
      Simple setup
    Use cases
      Container development
      Cloud-native work
      Linux testing
    Ecosystem
      Rancher Desktop
      Colima
      Finch

Things people build with this

USE CASE 1

Run containerized applications on Mac without Docker Desktop by using containerd and nerdctl.

USE CASE 2

Develop and test Kubernetes workloads locally on a Mac with automatic file syncing.

USE CASE 3

Use Podman or Docker inside a lightweight Linux VM for cloud-native development.

USE CASE 4

Build tools like Rancher Desktop or Finch on top of Lima for simplified container management.

Tech stack

GocontainerdnerdctlDockerPodmanKubernetes

Getting it running

Difficulty · moderate Time to first run · 30min

Requires macOS with virtualization support and downloading/installing the VM runtime binary.

Use freely for any purpose including commercial. Keep the notice and disclose changes to the patent grant.

In plain English

Lima is a tool for running Linux virtual machines on a Mac, written in Go. It provides automatic file sharing between your Mac and the Linux VM, and port forwarding, similar to how WSL2 works on Windows. The original purpose was to make it easy for Mac users to run containerd and nerdctl (container tools popular in the cloud-native ecosystem), but Lima works for any Linux workload, not just containers. Beyond containerd, Lima supports other container runtimes including Docker, Podman, and Kubernetes, and it also runs on Linux and NetBSD hosts. Starting a VM is just brew install lima and limactl start. It is an incubating project under the Cloud Native Computing Foundation (CNCF). Several popular tools are built on top of Lima, including Rancher Desktop, Colima, Finch, and Podman Desktop.

Copy-paste prompts

Prompt 1
How do I install Lima on my Mac and start my first Linux VM?
Prompt 2
Show me how to set up file sharing between my Mac and a Lima VM so I can edit code on my Mac and run it in Linux.
Prompt 3
How do I configure Lima to run Docker or Podman instead of containerd?
Prompt 4
What's the difference between Lima and Docker Desktop for Mac development?
Prompt 5
How do I use Lima with Kubernetes for local development?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.