DockerとDocker Composeのバージョン確認方法まとめ

はじめに

Dockerを使っていると、こんな場面でバージョンを確認したくなります。

インストールできているか確認したい
チームメンバーと環境を合わせたい
ドキュメントの対応バージョンを確認したい
docker compose と docker-compose どちらを使えばいいかわからない

この記事ではDockerとDocker Composeのバージョン確認方法をまとめます。

Dockerのバージョン確認

基本的な確認

docker --version

Docker version 27.3.1, build ce12230

インストールされているDockerのバージョンが1行で表示されます。

詳細情報を確認する

docker version

Client:
 Version:           27.3.1
 API version:       1.47
 Go version:        go1.22.7
 Git commit:        ce12230
 Built:             Fri Sep 20 11:38:18 2024
 OS/Arch:           darwin/arm64
 Context:           desktop-linux

Server: Docker Desktop 4.35.1 (173168)
 Engine:
  Version:          27.3.1
  API version:      1.47 (minimum version 1.24)
  Go version:       go1.22.7
  Git commit:       41ca978
  Built:            Fri Sep 20 11:41:19 2024
  OS/Arch:          linux/arm64

クライアント（CLI）とサーバー（Docker Engine）の両方のバージョンが確認できます。

インストール確認

コマンドが見つからない場合はDockerがインストールされていません。

docker --version
# zsh: command not found: docker

macOSの場合はDocker Desktopをインストールします。

# Homebrewでインストール
brew install --cask docker

Docker Composeのバージョン確認

Docker ComposeにはV1とV2があり、コマンドが異なります。

V2（現在の標準）

docker compose version

Docker Compose version v2.29.7

docker compose（スペース区切り）がV2です。Docker Desktop 3.4.0以降に同梱されており、現在の標準です。

V1（非推奨）

docker-compose --version

Docker Compose version v1.29.2, build 5becea4c

docker-compose（ハイフン区切り）がV1です。2023年7月にサポートが終了しており、現在は使用が推奨されません。

V1とV2の違い

	V1	V2
コマンド	`docker-compose`	`docker compose`
実装	独立したPythonバイナリ	Docker CLIのプラグイン
サポート	終了（2023年7月）	現在の標準
インストール	別途インストールが必要だった	Docker Desktopに同梱

新規プロジェクトでは docker compose（V2）を使ってください。

古いドキュメントやスクリプトで docker-compose が使われている場合は docker compose に読み替えて問題ありません。

Docker Desktopのバージョン確認

macOS・Windowsの場合、Docker Desktopのバージョンも確認できます。

docker version --format '{{.Server.Platform.Name}}'

Docker Desktop 4.35.1 (173168)

または docker info コマンドで確認します。

docker info

...
 Server Version: 27.3.1
 ...
 Operating System: Docker Desktop
 ...

バージョンをJSON形式で取得する

スクリプトで使いたい場合は --format オプションでJSON出力できます。

# クライアントのバージョンのみ取得
docker version --format '{{.Client.Version}}'
# 27.3.1

# Docker ComposeのバージョンをJSON形式で
docker compose version --json
# {"version":"v2.29.7"}

まとめ

確認内容	コマンド
Dockerバージョン（簡易）	`docker --version`
Dockerバージョン（詳細）	`docker version`
Docker Compose V2	`docker compose version`
Docker Compose V1（非推奨）	`docker-compose --version`
Docker情報全般	`docker info`

docker compose（スペース）がV2・現在の標準
docker-compose（ハイフン）はV1・非推奨
Docker Desktopをインストールすれば docker compose も同梱される