docker composeサブコマンドが使えないときは

Docker で docker compose サブコマンドが使用できない場合の対応方法

macOS や Linux の場合に Homebrew などでインストールした docker-compose がサブコマンドとして使用できない場合は、Docker CLI のプラグインが何らかの理由で登録されていないか登録が解除されている状態。

Homebrewのヒントを活用する場合

Homebrewで Docker CLI Plugin をインストールする場合は以下のようにヒントテキストが表示される

code:sh

Compose is a Docker plugin. For Docker to find the plugin, add "cliPluginsExtraDirs" to ~/.docker/config.json:

"cliPluginsExtraDirs": [

"/opt/homebrew/lib/docker/cli-plugins"

]

内容に従って ~/.docker/config.json に以下の内容を追記してプラグインの参照先を追加する

code:json

{

// ↓追加

"cliPluginsExtraDirs": [

"/opt/homebrew/lib/docker/cli-plugins"

]

}

追記後に動作するか確認する

code:sh

# docker compose を実行する

❯ docker compose version

Docker Compose version 2.26.1

リンクを設置して手動で解決する場合

ホームディレクトリに ~/.docker/cli-plugins を作成して docker-compose へのシンボリックリンクを配置する

code:sh

# プラグイン本体が存在することを確認する

ls -la /opt/homebrew/opt/docker-compose/bin/docker-compose

# Docker CLI Plugin ディレクトリを作る

mkdir -p ~/.docker/cli-plugins

# docker-compose のシンボリックリンクを作成する

ln -s /opt/homebrew/opt/docker-compose/bin/docker-compose ~/.docker/cli-plugins/docker-compose

# docker compose を実行する

❯ docker compose version

Docker Compose version 2.26.1