[note] Mac 不裝 Docker Desktop，改用 Colima 常見問題整理

📌 介紹

在 Mac 上要用 Docker，不一定要裝官方的 Docker Desktop，也可以改用像 Colima 這種比較輕量的選擇。不過，如果之前有裝過 Docker Desktop，後來又直接用 Homebrew 裝 Docker CLI，可能會因為一些舊設定沒清乾淨，遇到一些錯誤。

🚀 操作

錯誤訊息

# 錯誤 1
docker: Cannot connect to the Docker daemon at unix:///Users/XXXXXXXX/.docker/run/docker.sock. Is the docker daemon running?

# 錯誤 2
docker: error getting credentials - err: exec: "docker-credential-desktop": executable file not found in $PATH, out: ``

原因

因為剛開始使用 Docker Desktop 安裝，而後又將其刪除，改用 Colima，然原先的設定繼續沿用，故造成錯誤。

解法

錯誤 1

直接使用 brew install docker 安裝的是 Docker 的 CLI，而非 Docker Engine。因為 Docker Engine 必須跑在 Linux-based 的系統上，但是 mac 並非使用 Linux，所以需要額外開 VM。過去 Docker Desktop 會在背後開 VM，所以沒注意到，這次將 Docker Desktop 移除就需要額外準備 VM 給 Docker 運作。

1. 安裝 colima

   brew install colima

2. 執行 colima

   colima start

3. 正常操作 Docker 指令

錯誤 2

若一開始先安裝 Docker Desktop 有些設定會沿用，進而導致錯誤發生。

1. 至 config.json 中修改

   nano ~/.docker/config.json

2. 把裡面的這段刪除

   {
     "credsStore": "desktop"
   }

🔁 Recap

這篇筆記整理了兩個常見錯誤：

1. Docker 無法連線到 daemon
2. 找不到 docker-credential-desktop 導致憑證錯誤

🔗 參考資料

• Day 07：Developing for Kubernetes with KinD - MacOS
• 使用 Colima 快速打造 Kubernetes 開發環境