docker version

docker version

docker version은 Docker의 각 구성 요소 버전 정보를 보여주는 명령이에요. 설치된 Docker의 버전을 한눈에 확인하고 싶을 때 사용해요.

출처: 문서

본문

docker version 명령은 독립적으로 버전이 관리되는 모든 Docker 구성 요소의 현재 버전 번호를 출력해요. --format 옵션으로 출력을 커스터마이즈할 수 있어요.

docker version [OPTIONS]

docker version은 Docker 구성 요소들의 버전 번호를 출력하는 반면, docker --version 플래그는 사용 중인 Docker CLI의 버전 번호만 출력해요.

기본 출력

기본 출력은 모든 버전 정보를 두 섹션으로 나눠 보여줘요. Client 섹션은 Docker CLI와 클라이언트 구성 요소, Server 섹션은 Docker Engine과 containerd, runc 같은 OCI 런타임 등 엔진이 사용하는 구성 요소 정보를 담아요.

$ docker version

Client: Docker Engine - Community
 Version:           28.5.1
 API version:       1.51
 Go version:        go1.24.8
 Git commit:        e180ab8
 Built:             Wed Oct  8 12:16:17 2025
 OS/Arch:           darwin/arm64
 Context:           remote-test-server

Server: Docker Desktop 4.19.0 (12345)
 Engine:
  Version:          27.5.1
  API version:      1.47 (minimum version 1.24)
  Go version:       go1.22.11
  Git commit:       4c9b3b0
  Built:            Wed Jan 22 13:41:24 2025
  OS/Arch:          linux/amd64
  Experimental:     true
 containerd:
  Version:          v1.7.25
  GitCommit:        bcc810d6b9066471b0b6fa75f557a15a1cbf31bb
 runc:
  Version:          1.2.4
  GitCommit:        v1.2.4-0-g6c52b3f
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0

클라이언트/서버 버전

Docker는 클라이언트/서버 구조라서, 로컬의 Docker CLI로 원격 머신(클라우드나 가상 머신 등)에서 실행 중인 Docker Engine을 제어할 수 있어요.

$ docker context use remote-test-server
remote-test-server

$ docker version

Client: Docker Engine - Community
 Version:           28.5.1
 API version:       1.51
 ...
Server: Docker Engine - Community
 Engine:
  Version:          27.5.1
  API version:      1.47 (minimum version 1.24)
  ...

API 버전과 버전 협상

클라이언트가 사용하는 API 버전은 연결하는 Docker Engine에 따라 달라져요. CLI와 Engine은 API 버전 협상(negotiation)을 거쳐 양쪽 모두가 지원하는 가장 높은 API 버전을 선택해요.

DOCKER_API_VERSION 환경 변수로 API 버전을 강제할 수도 있어요. 이 변수는 디버깅에 유용하고, 설정하면 API 버전 협상을 끄게 돼요.

$ env | grep DOCKER_API_VERSION
DOCKER_API_VERSION=1.50

$ docker version --format '{{.Client.APIVersion}}'
1.50

$ unset DOCKER_API_VERSION
$ docker version --format '{{.Client.APIVersion}}'
1.51

지원하는 옵션은 다음과 같아요.

예시

서버 버전을 가져오는 예시예요.

$ docker version --format '{{.Server.Version}}'

28.5.1

클라이언트가 사용하는 API 버전을 출력하는 예시예요.

$ docker version --format '{{.Client.APIVersion}}'

1.51

원시 JSON 데이터를 덤프하는 예시예요.

$ docker version --format '{{json .}}'

{"Client":"Version":"28.5.1","ApiVersion":"1.51", ...}

더 알아보기

• docker system info
• docker context