[Docker] 'docker --version'과 'docker version'

'docker --version'과 'docker version'

클라이언트 버전만 확인하느냐, 클라이언트 서버 전체 상태를 확인하느냐의 차이가 있습니다.

'docker --version'으로 클라이언트 버전 확인

'docker version'으로 클라이언트와 서버 버전 동시 확인

---

1. 명령 목적의 차이

명령어	목적	설명
docker --version	클라이언트 버전 확인	설치된 Docker 클라이언트 프로그램의 버전만 간단히 보여줍니다.
docker version	클라이언트·서버 전체 상태 확인	클라이언트뿐 아니라 Docker 데몬(서버)의 버전 정보까지 제공합니다.

---

2. 출력 정보 비교

docker --version

아주 간단한 버전 정보만 출력합니다.

Docker version 27.5.1, build 27.5.1-0ubuntu3~24.04.2

docker version

상세 상태 정보를 제공합니다.

Client: Docker Engine - Community
 Version:           27.5.1
 API version:       1.45

Server: Docker Engine - Community
 Engine:
  Version:          27.5.1
  API version:      1.45
  OS/Arch:          linux/amd64
...

즉 docker version은 서버가 정상 실행 중인지까지 확인할 수 있습니다.

---

3. 실전 운영 관점 정리

언제 docker --version을 쓰나?

• Docker 설치 직후 버전만 빠르게 확인할 때
• 스크립트에서 단순 버전 체크 목적

언제 docker version을 쓰나?

• Docker 데몬 상태를 확인해야 할 때
• 클라이언트와 서버 API 버전이 맞는지 점검할 때
• 문제 해결 및 진단 상황

---

4. 개발 및 운영에서 중요한 포인트

1. Docker는 Client 프로그램과 Server(daemon) 프로그램으로 구성됩니다.
2. docker version은 양쪽 버전 및 통신 상태를 확인합니다.
3. Docker Engine이 멈춰 있으면 docker version에서 Server 항목이 표시되지 않거나 에러가 발생합니다.

예시 에러:

Cannot connect to the Docker daemon

이 경우 Docker 서비스 시작이 필요합니다.

sudo systemctl start docker

---

5. 결론 요약

항목	docker --version	docker version
출력 범위	클라이언트 버전	클라이언트 + 서버 상세 정보
용도	설치 확인	상태 진단 및 서버 연결 확인
정리	간단 확인용	전문 관리용

개발자와 서버 운영자라면 항상 docker version을 기준으로 확인하는 것이 좋습니다.
docker --version은 가벼운 설치 확인용입니다.