Fixing UID Mapping Issues in Lima for Rootless Docker

Wed, 16 Apr 2025 00:23:00 +0900

The Symptom

You’ve installed Lima using the default Docker template on macOS, and when launching your instance, it gets stuck here:

INFO[0057] [hostagent] Waiting for the optional requirement 1 of 1: "user probe 1/1"

That cryptic line basically means: Docker’s not ready yet.

Let’s SSH into the instance to investigate:

limactl shell local

Then try to manually install Docker in rootless mode:

dockerd-rootless-setuptool.sh install

Oops:

[rootlesskit:parent] error: failed to setup UID/GID map: newuidmap 3326 [0 222586300 1 1 524288 1073741824] failed: newuidmap: write to uid_map failed: Invalid argument
: exit status 1
[ERROR] RootlessKit failed, see the error messages and https://rootlesscontaine.rs/getting-started/common/ . Set --force to ignore

So what happened here?

Lima on FIZI

Fixing UID Mapping Issues in Lima for Rootless Docker

The Symptom