docker-compose コマンドが見つからない（command not found）

要約

docker-compose: command not found の主因は、ハイフン付きの Compose V1 が 2023 年に End of Life となり、現在の Docker では docker compose（スペース区切りのサブコマンド）に統合されたことです。
まず docker compose version を実行し、こちらが動くなら呼び出し側を新形式へ書き換えれば解決します。

実行例

docker:cli イメージから単体の docker-compose を外し、Compose がプラグインとしてだけ入っている状態で始めている。docker-compose version もそれを直接呼ぶスクリプトも not found で終了コード 127 になる一方、cli-plugins には docker-compose が置かれていて docker compose version は v5.5.1 を返し、呼び出しを docker compose に書き換えたスクリプトはサービス名 web を出力して終了コード 0 で通った。

$ docker-compose version
sh: /recipe.sh: line 0: docker-compose: not found
終了コード: 127（127 = そのコマンドが PATH に無い）

$ ls /usr/local/libexec/docker/cli-plugins
docker-buildx
docker-compose

$ docker compose version
Docker Compose version v5.5.1
終了コード: 0（0 なら V2 は有効）

$ cat deploy.sh
#!/bin/sh
docker-compose config --services

$ sh deploy.sh
deploy.sh: line 2: docker-compose: not found
終了コード: 127

$ cat deploy.sh
#!/bin/sh
docker compose config --services

$ sh deploy.sh
web
終了コード: 0（0 なら解消）

— 2026-09-17 時点の出力

よくある原因

1. V2 のみインストールされている: Docker Desktop や新しい docker-ce には Compose V2 がプラグインとして同梱されるが、docker-compose 単体バイナリは入らない。
2. compose プラグイン未導入: Linux に Engine だけ入れた場合、docker-compose-plugin を別途インストールしないと両形式とも使えない。
3. PATH の問題: プラグインは /usr/libexec/docker/cli-plugins 等に置かれ、ここが壊れているとサブコマンドも認識されない。
4. 古いスクリプト: 既存の Makefile・CI が docker-compose up をハードコードしている。

解決策

1. V2 形式に置き換える

最も確実なのはコマンド呼び出しを新形式へ変えることです。

# 旧
docker-compose up -d
# 新（推奨）
docker compose up -d

docker compose version が Docker Compose version v2.x や v5.x を返せば、プラグイン形式の Compose は有効です。
Compose は 2025 年 12 月のメジャーアップデートで v3・v4 を飛ばして v5.0.0（新しいタブで開く）↗ になりました（旧 Compose ファイル形式の 2.x / 3.x との混同を避けるため）。
v5 でも呼び出し方は同じ docker compose です。
詳細は公式の移行ガイド（新しいタブで開く）↗を参照してください。

2. Linux で compose プラグインを入れる

Engine のみの環境では plugin パッケージを追加します。

sudo apt-get update
sudo apt-get install docker-compose-plugin
docker compose version

3. 互換エイリアスを張る

スクリプトを今すぐ変更できない場合は一時的にエイリアスで橋渡しします。

echo 'alias docker-compose="docker compose"' >> ~/.bashrc
source ~/.bashrc

ただし CI では shell の alias が効かないため、最終的にはコマンド本体を docker compose へ書き換えるのが正攻法です。