Using colima and Docker Engine on Apple Silicon (M1 Chip)

colima-docker-apple-silicon.md

Using colima and Docker Engine on Apple Silicon (M1 Chip)

This tutorial uses Homebrew to install colima and Docker.

It was tested on Apple MacBook Pro (13-inch, M1, 2020) 8G and macOS Monterey version 12.1 (21C52).

Uninstall any Docker version

Make sure you have fully uninstall any versions of Docker. You can check using:

• docker ps
• which docker

Installation, starting and testing

First, install colima and docker by brew:

$ brew install colima docker

Then, initialize and start colima, to be the daemon of docker:

$ colima start

Finally, test the docker (it must show an empty list of containers):

$ docker ps
CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES

Here's some another tests:

$ docker run hello-world
$ docker run -it ubuntu bash

To get out of the ubuntu bash, type exit and enter.

Troubleshooting

If you got a error about docker-credentials-xxx, open the file ~/.docker/config.json and delete the credsStore. Maybe the file will looks like this:

{
  "auths": {},
  "currentContext": "colima"
}