はじめに

最近10年使ったiMacがとうとうOSバージョンが古すぎて様々なソフトウェアやツールの最新バージョンがサポートしなくなったため新たにMac mini M4 Proを購入しました。せっかくなのでクリーンな状態から環境構築をしていこうと思い、この記事ではDockerの環境構築の手順を記します。

ちょうど2025年1月8日にMacのDocker Desktopがマルウェア扱いされて起動不能になる不具合が世界中で報告され話題になりました。¹ Docker DesktopはDocker環境を構築するのに最もお手軽な方法ですが、このような問題が出ている中新調したクリーンなMacに新たにインストールするのはさすがに躊躇してしまったので、今回は Docker Desktopを使わないやり方 として知られる Colima を使った方法でMacのDocker環境構築をしようと思いました。

環境情報

macOS: Sequoia 15.1
チップ: Apple M4 Pro
Homebrew: バージョン 4.4.15

前提条件

Homebrew がインストールされていることが前提です。まだの方はこちらからインストールしてください。

インストール

Colima をインストール
```
brew install colima
```
Docker CLI をインストール
```
brew install docker
```
Docker Compose CLI をインストール
```
brew install docker-compose
```
Buildx をインストール

docker build は Deprecated のメッセージ

The legacy builder is deprecated and will be removed in a future release.
Install the buildx component to build images with BuildKit:
https://docs.docker.com/go/buildx/

が出るため指示に従い、 buildx をインストールする。
```
brew install docker-buildx
```

Dockerの設定

~/.docker/config.json が作られているのでこれを以下のように修正する。
(私の環境では currentContext は最初から colima になっていました。)

~/.docker/config.json

{
    "auths": {},
    "currentContext": "colima",
    "cliPluginsExtraDirs": [
        "/opt/homebrew/lib/docker/cli-plugins"
    ]
}

cliPluginsExtraDirs を設定することで docker-compose を docker compose で実行できるようになる。パスは Homebrew のインストール先により異なる場合もある。正しいパスは以下のコマンドで確認可能。

brew info docker-compose

実行

Colima で VM を起動する
```
colima start
```
Docker CLI の確認
```
docker version
```
Docker Compose CLI の確認
```
docker compose version
```
VM の停止
```
colima stop
```
VM の停止後は Docker Daemon が動いていないため、docker コマンドはちゃんと使えなくなっている。

おまけ

ホストOS再起動の度に自動で colima start する方法

以下のコマンドで、VM の起動とホスト再起動時の自動 colima start の設定を有効化する。

brew services start colima

設定を無効化したい場合は

brew services stop colima

参考

Running Docker on macOS Without Docker Desktop - DEV Community
Colima で Docker と Docker Compose を使ってみた
docker cli-plugins の設定方法が変わったので対応した

Mac is detecting Docker as a malware and keeping it from starting #7520 ↩