Skip to content

Instantly share code, notes, and snippets.

@mbiemann
Last active August 2, 2024 13:20
Show Gist options
  • Save mbiemann/cbcbc795e619f14d14dfa9d9d1c85a8e to your computer and use it in GitHub Desktop.
Save mbiemann/cbcbc795e619f14d14dfa9d9d1c85a8e to your computer and use it in GitHub Desktop.
Using colima and Docker Engine on Apple Silicon (M1 Chip)

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"
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment