switching batect from docker desktop to colima

assumptions:

• you already have a working docker client (brew install docker)
• you have uninstalled docker desktop (e.g. brew uninstall —force —cask docker)

instructions

1. install colima and docker-credential-helper:

brew install colima docker-credential-helper

2. start colima

colima start

3. export the path to the colima socket so batect can use it:

export DOCKER_HOST="unix:///${HOME}/.colima/docker.sock"

4. ensure docker is configured to use the correct credential helper - edit ~/.docker/config.json and ensure it includes the following:

"credsStore": "osxkeychain",

In my case this was set to “desktop” which fails because I don’t have an executable docker-credential-desktop. With the setting above docker will use docker-credential-osxkeychain which is provided by the docker-credential-helper homebrew package.

That’s it, you should now be able to run batect without errors.