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

This tutorial uses [Homebrew](https://brew.sh) to install [colima](https://github.com/abiosoft/colima/) and [Docker](https://docs.docker.com/engine/).

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:

```sh
$ brew install colima docker
```

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

```sh
$ colima start
```

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

```sh
$ docker ps
CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES
```

Here's some another tests:

```sh
$ 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:

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