# Lima v2.0.3

2025-12-25 · [Original release notes](https://github.com/lima-vm/lima/releases/tag/v2.0.3) · [Full summary](https://ratatosk.io/en/releases/lima/v2.0.3)

Important fixes 3 · Enhancements 2 · Dependency updates 8 · Other changes 12

## Important fixes (3)

### Recursive `limactl copy` directory placement fixed

- Affects: recursive directory transfers with `limactl copy` using rsync

Before the fix, a v2 regression could put the destination directory in an extra directory when the copy path’s trailing slash affected placement. Directory placement now handles trailing slashes consistently with scp, in both host-to-instance and instance-to-host copies.

>   - Fix #4468 "[v2 regression] `limactl copy` (w/ rsync) puts the destination directory in an extra directory" (#4482)
> - [v2 regression] limactl copy (w/ rsync) puts the destination directory in an extra directory
> area/cli priority/high regression
> lima-vm/lima#4468 · by Filter by author AkihiroSuda was closed on Dec 23, 2025 · v2.0.3
> 1

### Configurable instance selection for `nerdctl.lima`

- Affects: Non-default Lima instances selected with `$LIMA_INSTANCE` (Inferred)

When `$LIMA_INSTANCE` is set, `nerdctl.lima` uses that instance; when it is unset, the script uses `default`.

> - fix: make nerdctl.lima respect LIMA_INSTANCE
> Unread
> lima-vm/lima # 4432 · by Kim-Yukyung was merged Dec 7, 2025
> 1
>   - `nerdctl.lima`: respect `$LIMA_INSTANCE` (#4432, thanks to @Kim-Yukyung)

https://github.com/lima-vm/lima/milestone/67?closed=1

### Fedora guest boot loop avoided

- Affects: Fedora guests (Inferred)

The loop is avoided when DNF network issues occur during boot.

> - Avoid boot loop when there are dnf network issues
> guest/fedora

https://github.com/lima-vm/lima/milestone/67?closed=1

## Enhancements (2)

- Configurable ASIF disk images for the vz driver (To use: Set `vmType.vz.diskImageFormat` to `"asif"`; this requires macOS 26 or higher.)
- `no_vz` build constraint for the Darwin main file

## Dependency updates (8)

8 more, none mentioning security

- `- Update from v2.2.0 to [v2.2.1](https://github.com/containerd/nerdctl/releases/tag/v2.2.1) (#4484)`
- `- build(deps): bump github/codeql-action from 4.31.6 to 4.31.7 dependencies github_actions Unread lima-vm/lima # 4435 · by dependabot[bot] was merged Dec 8, 2025`
- `- build(deps): bump the golang-x group across 1 directory with 4 updates dependencies go Unread lima-vm/lima # 4443 · by dependabot[bot] was merged Dec 9, 2025`
- `- build(deps): bump github.com/miekg/dns from 1.1.68 to 1.1.69 dependencies go Unread lima-vm/lima # 4450 · by dependabot[bot] was merged Dec 12, 2025`
- `- build(deps): bump the k8s group across 1 directory with 3 updates dependencies go Unread lima-vm/lima # 4447 · by dependabot[bot] was merged Dec 11, 2025`
- `- build(deps): bump github/codeql-action from 4.31.8 to 4.31.9 dependencies github_actions Unread lima-vm/lima # 4464 · by dependabot[bot] was merged Dec 18, 2025`
- `- build(deps): bump github.com/goccy/go-yaml from 1.19.0 to 1.19.1 dependencies go Unread lima-vm/lima # 4467 · by dependabot[bot] was merged Dec 19, 2025 1`
- `- build(deps): bump github.com/mikefarah/yq/v4 from 4.48.2 to 4.49.2 dependencies go Unread lima-vm/lima # 4404 · by dependabot[bot] was merged Nov 25, 2025`

## Other changes (12)

- vz compilation excluded by `no_vz` build tags
- External driver waits for server-side `Start()` completion
- Error logging now uses `logger.WithError`
- QEMU 10.1.1 change reverted on the macOS test runner
- X and Mastodon account setup documentation
- CPU count validation
- GitHub Actions `actions/cache` updated
- Experimental RKE2 template updated to 1.34
- Lima now requests `virtio-scsi` from QEMU
- nerdctl documentation says stargz no longer needs ubuntu-24.04
- VZ registration build constraint excludes `no_vz` builds
- Lima checks input is a TTY before use

---

Summaries are produced by AI, so they can be wrong, and they are provided without warranty.
