Docker Desktop から Colima に乗り換えた際の作業メモ

Posted at 2026-03-31

はじめに

Docker Desktop が利用できなくなる状況になったため、代替手段を検討した結果 Colima に移行しました。
移行自体は非常にスムーズで、コマンド数本で完結しました。同じ状況の方の参考になれば幸いです。

Colima は、macOS 上で Docker コンテナを動かすための軽量なランタイムです。内部的には Lima（Linux 仮想マシン）を使っており、Docker Desktop なしで docker コマンドをそのまま使えます。

主なメリット:

Colima、Docker CLI、Docker Compose をまとめてインストールします。

brew install colima docker docker-compose

Docker Desktop 用の設定が残っているため、2 箇所修正が必要です。

変更前:

{
  "credsStore": "desktop",
  "currentContext": "desktop-linux"
}

変更後:

{
  "credsStore": "osxkeychain",
  "cliPluginsExtraDirs": [
    "/opt/homebrew/lib/docker/cli-plugins"
  ]
}

currentContext は colima start 時に自動で colima に書き換えられるため、手動での変更は不要です。

変更点の説明:

キー	変更内容	理由
`credsStore`	`desktop` → `osxkeychain`	Docker Desktop 独自の `docker-credential-desktop` コマンドがなくなるため、macOS 標準キーチェーンに変更
`cliPluginsExtraDirs`	追加	Homebrew でインストールした docker-compose プラグインのパスを指定。`docker compose` コマンドを有効にするために必要

colima start

起動すると Docker コンテキストが自動的に colima に切り替わります。

# Docker CLI の確認
docker version

# Docker Compose の確認
docker compose version

# コンテナ実行テスト
docker run --rm hello-world

Hello from Docker! が表示されれば成功です。

# 起動
colima start

# 停止
colima stop

# 状態確認
colima status

ログイン時に自動起動したい場合は以下を設定します。

# 自動起動を有効化
brew services start colima

# 自動起動を無効化
brew services stop colima

Docker Desktop は Homebrew 管理外のため、アプリケーションフォルダから通常どおり削除するだけで OK です。

移行の手間はほぼなく、体感的な使用感も Docker Desktop と変わりません。Docker Desktop から離れたい方にはおすすめです。