Docker Version 사용법 완벽 가이드! Docker 버전 확인하기

Docker를 설치하거나 운영하다 보면 현재 설치된 Docker 버전이 무엇인지 확인해야 하는 상황이 자주 발생합니다. 새로운 기능 사용 여부를 확인하거나, 서버 간 버전 차이를 비교하거나, 오류 원인을 분석할 때 Docker 버전 정보는 매우 중요한 역할을 합니다.

이럴 때 사용하는 명령어가 바로 docker version입니다.

Docker Version은 Docker Client와 Docker Engine(Server)의 버전을 확인하는 명령어입니다. 설치된 Docker의 버전뿐 아니라 API 버전, Go 버전, 운영체제(OS), 아키텍처 등 다양한 정보를 함께 확인할 수 있어 설치 확인과 장애 분석에서 자주 사용됩니다.

이번 글에서는 Docker Version의 개념부터 기본 사용법, 출력 결과 해석, 주요 옵션, 실무 활용 사례까지 자세히 알아보겠습니다.

Docker Version이란 무엇인가?

Docker Version은 현재 시스템에 설치된 Docker의 버전 정보를 출력하는 명령어입니다.

Docker Client와 Docker Server의 버전을 각각 확인할 수 있으며, API 버전과 Build 정보도 함께 제공합니다.

Docker 설치 직후 정상적으로 설치되었는지 확인할 때 가장 먼저 실행하는 명령어 중 하나입니다.

Docker Version은 언제 사용하는가?

다음과 같은 상황에서 자주 사용됩니다.

• Docker 설치 확인
• 버전 확인
• API 버전 확인
• 서버 환경 점검
• 기능 지원 여부 확인
• 장애 분석

특히 운영 서버와 개발 서버의 Docker 버전을 비교할 때 많이 사용됩니다.

Docker Version 기본 사용법

가장 기본적인 명령어는 다음과 같습니다.

docker version

출력 예시는 다음과 같습니다.

Client:
 Version:           28.3.2
 API version:       1.51
 Go version:        go1.24
 Git commit:        abc123

Server:
 Engine:
  Version:          28.3.2
  API version:      1.51
  Go version:       go1.24
  OS/Arch:          linux/amd64

Client와 Server의 버전 정보를 각각 확인할 수 있습니다.

Docker Client와 Server의 차이

Docker Version에는 두 가지 정보가 출력됩니다.

항목	설명
Client	사용자가 실행하는 Docker 명령어 프로그램
Server	실제 컨테이너를 관리하는 Docker Engine

일반적으로 두 버전은 동일하지만 환경에 따라 다를 수도 있습니다.

API 버전 확인

Docker API 버전도 함께 확인할 수 있습니다.

API version: 1.51

Docker SDK나 자동화 프로그램을 개발할 때 매우 중요한 정보입니다.

출력 형식 지정

필요한 정보만 출력하려면 --format 옵션을 사용할 수 있습니다.

예를 들어 Client 버전만 확인하려면 다음과 같이 실행합니다.

docker version --format '{{.Client.Version}}'

Server 버전만 확인하는 것도 가능합니다.

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

자동화 스크립트에서 자주 사용하는 방식입니다.

Docker 설치 확인

Docker가 정상적으로 설치되어 있는지 확인하려면 다음 명령을 실행합니다.

docker version

정상적으로 버전 정보가 출력된다면 Docker 설치가 완료된 것입니다.

반대로 오류가 발생한다면 Docker Engine이 실행되지 않았거나 설치에 문제가 있을 가능성이 있습니다.

Docker Version으로 확인할 수 있는 정보

Docker Version 명령을 통해 다음과 같은 정보를 확인할 수 있습니다.

• Docker Client 버전
• Docker Engine 버전
• API 버전
• Go 버전
• Git Commit
• 운영체제(OS)
• CPU 아키텍처
• Build 정보

설치 상태와 호환성을 확인하는 데 매우 유용한 정보들입니다.

Docker Version 실무 활용 예제

Docker Version은 Docker 설치 여부 확인뿐 아니라 운영 환경의 버전 관리, 서버 간 호환성 확인, 업그레이드 계획 수립 등 다양한 상황에서 활용됩니다. 특히 여러 대의 Linux 서버를 운영하는 환경에서는 가장 먼저 실행하는 점검 명령어 중 하나입니다.

Docker 설치 확인

Docker가 정상적으로 설치되었는지 확인합니다.

docker version

정상적으로 설치되어 있다면 Client와 Server 정보가 모두 출력됩니다.

Client 버전만 확인

자동화 스크립트에서는 Client 버전만 확인하는 경우도 많습니다.

docker version --format '{{.Client.Version}}'

출력 예시입니다.

28.3.2

Server 버전만 확인

Docker Engine 버전만 확인하려면 다음 명령을 사용합니다.

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

출력 예시입니다.

28.3.2

운영 서버의 버전을 비교할 때 자주 사용하는 방법입니다.

JSON 형식으로 출력

자동화 도구나 스크립트에서 사용하기 위해 JSON 형식으로 출력할 수도 있습니다.

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

Ansible이나 CI/CD 환경에서도 자주 활용됩니다.

Linux 서버 문제 해결

신규 Ubuntu 서버에 Docker를 설치한 후 컨테이너가 실행되지 않는 문제가 발생했습니다.

먼저 Docker 버전을 확인했습니다.

docker version

다음과 같은 오류가 출력되었습니다.

Cannot connect to the Docker daemon at unix:///var/run/docker.sock

Docker Client는 정상적으로 설치되어 있었지만 Docker Engine이 실행되고 있지 않았습니다.

서비스 상태를 확인했습니다.

systemctl status docker

Docker 서비스가 중지되어 있는 것을 확인한 후 다음 명령으로 실행했습니다.

sudo systemctl start docker

다시 Docker Version을 확인했습니다.

docker version

이번에는 Client와 Server 정보가 모두 정상적으로 출력되었고 Docker 컨테이너도 정상적으로 실행되었습니다.

Docker Version 사용 시 주의사항

Docker Version을 사용할 때는 다음 사항을 알아두는 것이 좋습니다.

첫 번째는 Client 정보만 출력된다고 해서 Docker가 정상 동작하는 것은 아닙니다.

Server 정보까지 출력되어야 Docker Engine이 정상적으로 실행되고 있는 상태입니다.

두 번째는 Client와 Server 버전이 약간 다를 수 있습니다.

하지만 너무 큰 버전 차이는 호환성 문제를 일으킬 수 있으므로 가능하면 동일한 버전을 유지하는 것이 좋습니다.

세 번째는 최신 기능을 사용하려면 Docker 버전이 충분히 최신인지 확인해야 합니다.

일부 기능은 오래된 버전에서는 지원되지 않습니다.

네 번째는 운영 서버를 업그레이드하기 전에 현재 버전을 반드시 기록해 두는 것이 좋습니다.

문제가 발생했을 때 원인 분석에 도움이 됩니다.

Best Practice

Docker Version을 사용할 때는 다음과 같은 방법을 추천합니다.

• Docker 설치 후 가장 먼저 버전을 확인합니다.
• Client와 Server 버전이 모두 출력되는지 확인합니다.
• 운영 서버와 개발 서버의 버전을 동일하게 유지합니다.
• 자동화 스크립트에서는 --format 옵션을 활용합니다.
• 업그레이드 전후 버전을 기록합니다.
• 새로운 기능을 사용할 때는 지원 버전을 먼저 확인합니다.

이러한 방법을 적용하면 Docker 환경을 더욱 안정적으로 운영할 수 있습니다.

자주 묻는 질문

Docker Version과 Docker Info의 차이는 무엇인가요?

Docker Version은 버전 정보를 확인하는 명령어입니다.

Docker Info는 Docker Engine의 상세 환경 설정과 시스템 정보를 확인하는 명령어입니다.

Client만 출력되고 Server는 보이지 않습니다.

Docker Engine이 실행되지 않았을 가능성이 높습니다.

systemctl status docker로 서비스를 확인해 보세요.

Docker 버전이 다르면 문제가 발생할 수 있나요?

일부 기능이나 API에서 호환성 문제가 발생할 수 있습니다.

운영 환경에서는 가능한 동일한 버전을 사용하는 것이 좋습니다.

Docker Desktop에서도 사용할 수 있나요?

네.

Linux뿐 아니라 Windows와 macOS의 Docker Desktop에서도 동일하게 사용할 수 있습니다.

마무리

Docker Version은 현재 설치된 Docker Client와 Docker Engine의 버전 정보를 확인하는 가장 기본적인 명령어입니다.

설치 확인, 서버 점검, 버전 관리, 호환성 확인 등 다양한 운영 작업에서 활용되며, Docker 문제를 분석할 때 가장 먼저 실행하는 명령어 중 하나입니다.

Docker Info, Docker Inspect, Docker System Info와 함께 활용하면 Docker 환경을 더욱 정확하게 파악하고 안정적으로 운영할 수 있습니다.