---
title: "Lima & UTM: CLI vs. GUI Virtualization on macOS – Comprehensive Research Notes"
category: "notes"
summary: "--- aliases: - \"Lima & UTM: CLI vs. GUI Virtualization on macOS\" ---"
date: "2025-06-22"
---

---
aliases:
  - "Lima & UTM: CLI vs. GUI Virtualization on macOS"
---
# Lima & UTM: CLI vs. GUI Virtualization on macOS – Comprehensive Research Notes

---

## ********Introduction**


- <font color="#00b050">Lima</font> is an open-source, command-line (CLI) tool for running Linux virtual machines (VMs) on macOS (Apple Silicon/Intel) and Linux. It is designed for developers, especially those working with containers (Docker, Podman, Kubernetes), and automates VM setup, networking, and file sharing.
- **UTM** is a graphical user interface (GUI) application for QEMU, enabling easy setup and management of virtual machines for a wide range of operating systems, including Linux, Windows, and macOS. UTM is intended for users who prefer a visual interface and manual configuration.

---

## **Installation via Homebrew**

### **Lima**

```bash
brew install lima
```
- **Why use Homebrew?** Homebrew simplifies installation and updates, integrates well with macOS development environments, and is scriptable.
- **Why choose Lima?** Ideal for developers who need fast, automated Linux VMs, container integration, and command-line control.

### **UTM**

```bash
brew install --cask utm
```
- **Why use Homebrew?** Homebrew Cask allows for easy installation and updates of GUI apps from the command line.
- **Why choose UTM?** Best for users who want a GUI, need to run a variety of operating systems (including desktop environments), and prefer manual setup.

---

## **CLI vs. GUI: Lima and UTM Compared**

| Feature                | Lima (CLI)                                | UTM (GUI)                                   |
|------------------------|-------------------------------------------|---------------------------------------------|
| **Interface**          | Command-line                              | Graphical                                   |
| **Target Audience**    | Developers, container users               | General users, desktop OS virtualization    |
| **Automation**         | High (network, file sharing, templates)   | Manual setup                                |
| **Container Integration** | Built-in (Docker, Podman, Kubernetes)  | Not built-in                                |
| **OS Templates**       | Many Linux distros, Kubernetes            | User provides ISO, sets up manually         |
| **Performance**        | Lightweight, fast for dev workloads       | Heavier, more general-purpose               |
| **Cross-Architecture** | Yes (ARM/Intel, via QEMU)                 | Yes, but less automated                     |
| **Ease of Use**        | CLI-focused, developer-friendly           | GUI-focused, user-friendly for beginners    |

---

## **Software Details & Core Features**

### **Lima**
- **Type:** Command-line tool
- **Platforms:** macOS (Apple Silicon & Intel), Linux
- **Architecture Support:** ARM and x86 emulation via QEMU
- **Key Features:**
  - Automated file sharing (host directories mounted in VM)
  - Automatic port forwarding
  - Deep integration with Docker, Podman, containerd, Kubernetes
  - Preset templates for popular Linux distros and Kubernetes
  - YAML config for resource and settings customization

### **UTM**
- **Type:** GUI application (front-end for QEMU)
- **Platforms:** macOS (Apple Silicon & Intel), iOS/iPadOS (limited)
- **Architecture Support:** ARM and x86 emulation via QEMU
- **Key Features:**
  - Visual VM creation and management
  - Supports a wide range of guest OSes (Linux, Windows, macOS, classic Mac OS)
  - Manual configuration of VM resources, storage, and networking
  - Directory sharing between macOS and VM
  - Snapshot and disk image management

---

## **Installation & Commands**

### **Lima Basic Commands**
- Start a VM: `limactl start <template>`
- List VMs: `limactl list`
- Stop a VM: `limactl stop <vm-name>`
- Delete a VM: `limactl delete <vm-name>`
- Shell into VM: `lima <vm-name>`

### **UTM Basic Workflow**
- Install via Homebrew Cask or download from the official site.
- Launch UTM app, use GUI to create a new VM, select ISO, configure resources, and start the VM.

---

## **Use Cases**

### **Lima**
- Development: Fast Linux environments for coding, testing, and running containers.
- Containerization: Docker, Podman, Kubernetes clusters in isolated VMs.
- Cross-platform Testing: Run ARM Linux on Intel Macs and vice versa.
- File Sharing: Edit code on Mac, run/test inside Linux VM with shared directories.
- Port Forwarding: Expose services from VM to host automatically.

### **UTM**
- Desktop Virtualization: Run Linux, Windows, macOS, or classic Mac OS in a GUI.
- Emulation: Test ARM/x86 operating systems.
- Manual VM Management: Fine-tune VM settings, storage, and networking.
- File Sharing: Share directories between host and guest OS.

---

## **Safety & Security**

- **Lima:** Sandboxed environments, protected VMs (prevent accidental deletion), configurable file access, open-source and auditable.
- **UTM:** Sandboxed VMs, manual control over shared resources, open-source and auditable.

---

## **Benchmarks & Performance**

- **Lima:** Lightweight, fast startup, optimized for development and container workloads, near-native performance for containers.
- **UTM:** Heavier, more resource-intensive, suitable for running full desktop environments, x86 emulation slower on Apple Silicon.

---

## **Why and Why Not Use Each**

### **Lima**
- **Why Use:** Automation, container integration, scriptable, efficient for development, easy to manage multiple VMs, integrates with macOS features.
- **Why Not Use:** Not ideal for running desktop environments or Windows VMs, CLI-only (less friendly for non-developers).

### **UTM**
- **Why Use:** Easy GUI, supports many OSes, flexible for desktop environments, good for beginners, manual control.
- **Why Not Use:** Manual setup, slower x86 emulation on Apple Silicon, less automation, not optimized for container workflows.

---

## **Research & Community Insights**

- **Lima:** Widely adopted by developers for local Kubernetes and Docker development. Praised for automation, container tool integration, and developer experience.
- **UTM:** Popular for running desktop OSes, recommended for beginners and those who need a GUI. Manual setup is more flexible but less automated.

---

### **Lima commands**

---

Here are the essential Lima command codes for installation, VM management, and common usage on macOS. These are ready for your reference or to copy into your notes.

---

## Lima: Essential Commands for macOS

### **1. Install Lima via Homebrew**
```bash
brew install lima
```


---

### **2. Start a New Virtual Machine**
- Start with the default template (Ubuntu):
```bash
limactl start default
```
- Or use a specific template (e.g., Docker, Fedora, Kubernetes):
```bash
limactl start template://docker
limactl start template://fedora
limactl start template://k8s
```


- **List available templates:**
```bash
limactl start --list-templates
```


---

### **3. Access the VM Shell**
```bash
lima
```
This drops you into a shell inside your running VM.[6]

---

### **4. Run Linux Commands in the VM**
```bash
lima sudo apt-get update
lima sudo apt-get install -y <package-name>
lima <command>
```
Example:
```bash
lima neofetch
```


---

### **5. Manage VMs**
- **List running VMs:**
```bash
limactl list
```
- **Stop a VM:**
```bash
limactl stop <vm-name>
```
- **Delete a VM:**
```bash
limactl delete <vm-name>
```


---

### **6. Container Integration**
- **Run a container using containerd:**
```bash
lima nerdctl run --rm hello-world
```


- **Run a container using Docker:**
```bash
limactl start template://docker
export DOCKER_HOST=$(limactl list docker --format 'unix://{{.Dir}}/sock/docker.sock')
docker run --rm hello-world
```


---

### **7. Kubernetes Integration**
```bash
limactl start template://k8s
export KUBECONFIG=$(limactl list k8s --format 'unix://{{.Dir}}/copied-from-guest/kubeconfig.yaml')
kubectl apply -f <file.yaml>
```


---

### **8. Advanced: Specify VM Type**
- Use Apple’s Virtualization.framework (faster, native on macOS 13+):
```bash
limactl start --vm-type=vz --mount-type=virtiofs
```


---

### **9. Check Lima Version**
```bash
lima --version
```

After you exit the Lima VM shell, here is how you can start and enter Lima again:

1. **To start the Lima VM (if not already running):**
   ```
   limactl start default
   ```
   This starts the VM named "default". If it is already running, this command will just confirm it is running without recreating it[2][6][8].

2. **To open a shell inside the running Lima VM:**
   ```
   limactl shell default
   ```
   or simply use the shortcut command:
   ```
   lima
   ```
   Both open a terminal shell inside the "default" Lima VM[6][8].

3. **To exit the Lima VM shell:**
   Inside the Lima shell, type:
   ```
   exit
   ```
   or press `Ctrl+D` to return to your macOS terminal[9].

4. **To stop the Lima VM when you are done:**
   ```
   limactl stop default
   ```
   This cleanly shuts down the VM to free system resources[6][8].

---

### Summary commands for managing Lima VM "default":

| Action               | Command                 |
|----------------------|-------------------------|
| Start VM             | `limactl start default` |
| Enter VM shell       | `limactl shell default` or `lima` |
| Exit VM shell        | `exit` or `Ctrl+D`      |
| Stop VM              | `limactl stop default`  |

This workflow lets you start, enter, exit, and stop Lima VMs cleanly and easily from the terminal[2][6][8].

Sources
[1] Command to exit the ssh session · Issue \#3125 · lima-vm/lima - GitHub https://github.com/lima-vm/lima/issues/3125
[2] start | Lima https://lima-vm.io/docs/reference/limactl_start/
[3] Error starting a virtual machine with Lima - trellis - Roots Discourse https://discourse.roots.io/t/error-starting-a-virtual-machine-with-lima/25293
[4] Colima fails to start: FATA[0600] error starting vm: error at 'creating ... https://github.com/abiosoft/colima/issues/905
[5] Keep getting error runing colima FATA[0001] error starting vm https://stackoverflow.com/questions/77195672/keep-getting-error-runing-colima-fata0001-error-starting-vm-error-at-startin
[6] lima man | Linux Command Library https://linuxcommandlibrary.com/man/lima
[7] Athena on Lima - ATLAS Software Documentation - CERN https://atlas-software.docs.cern.ch/athena/containers/lima
[8] limactl man | Linux Command Library https://linuxcommandlibrary.com/man/limactl
[9] Tools tools.command_line_interfaces

---

**Tip:**  
All Lima commands are run from your macOS terminal. You can customize VMs further by editing their YAML config files in `~/.lima/<instance>/lima.yaml`.[6]

For more details, visit the

[official Lima documentation][1].

---