To ultimately replace Docker Desktop with Colima on macOS

install-colima.md

To ultimately replace Docker Desktop with Colima on macOS

• completely delete Docker Desktop, then find leftovers in your system and remove them

find . -name '*docker*' 

• install Docker CLI

brew install docker

• install Docker Compose

brew install docker-compose

• optionally, install Docker Buildx

brew install docker-buildx

• install Kubernetes CLI (only if you need a Kubernetes cluster locally)

brew install kubernetes-cli

• install Colima

brew install colima

• start Colima and create a new virtual machine

NOTE: a new machine will contain 4 CPU, 4Gb RAM, 64GB disk size and use Apple Virtualization framework

colima start --cpu 4 --memory 4 --disk 64 --vm-type=vz --mount-type=virtiofs

• in order to start it with Kubernetes

colima start --kuberntetes

• to recognize docker-compose add to ~/.docker/config.json (from brew info docker-compose)

"cliPluginsExtraDirs": [
  "/opt/homebrew/lib/docker/cli-plugins"
]

• define Docker host environment variable adding it to your .zshrc

export COLIMA_HOME="$HOME/.colima"
export DOCKER_HOST="unix://$COLIMA_HOME/default/docker.sock"

• next time to start Colima

colima start

• ...or without Kubernetes

colima start --kubernetes=false

Happy coding!