Docker Desktop 설치 및 확인

도커(Docker)를 Windows나 macOS 같은 데스크탑 환경에서

쉽게 사용할 수 있도록 도와주는 Docker Desktop 설치 및 실행 과정을 포스팅해 보려고 합니다.

---

 

설치 파일 다운로드

도커 공식 문서 사이트에서 설치 파일을 받도록 하겠습니다. 화면을 조금 스크롤해서 내용을 읽어보면 WSL2 또는 Hyper-V 기반으로 Docker Desktop을 설치할 수 있다고 설명돼있다.

컨테이너 기술은 리눅스 기능을 기반으로 만들어졌기 때문에 반드시 리눅스 커널이 필요하다. 하지만 윈도우는 당연하게도 자체적으로는 리눅스 커널을 제공하지 않는다. 따라서 Docker를 실행하기 위해선 리눅스 환경을 가상화해야 한다. 이를 위해 두 가지 방식이 있다.

 

첫째, '리눅스 커널을 포함한 경량 VM'인 WSL2를 활용하는 방식이 있다. 둘째, Hyper-V 기반 전통적인 가상 머신 방식으로, 윈도우에 Hyper-V를 사용해 전체 리눅스 OS를 VM으로 올린 뒤 그 안에 Docker를 설치하여 실행한다. 이 방식은 안정적이지만 상대적으로 무겁고 Windows Pro 이상 버전에서만 가능하다는 특징도 있다. ※ WSL = Windows Subsystem for Linux

 

두 방식 모두 리눅스 커널 환경을 제공하므로 Docker 사용에는 차이가 없으니 저는 그냥 더 가볍다고 하는 WSL2 기반으로 설치하겠습니다.

 

 

WSL2 기반으로 설치 진행

'Use WSL 2 instead of Hyper-V' 항목을 선택한 채로 설치 진행. 만약 이걸 선택하지 않으면 Docker가 리눅스 컨테이너를 실행할 때, Hyper-V 가상 머신 방식을 사용함을 의미한다.

'Allow Windows containers to be used with this installation' 항목은 Docker 컨테이너가 리눅스말고 Windows 환경의 컨테이너도 쓸 수 있게 허용할지에 대한 항목이다. .NET Framework 기반 앱이나 IIS를 이용할 필요가 있다면 해당 항목을 체크하면 된다.

 

 

재부팅 후 서비스 약관 동의

설치가 완료되면 컴퓨터 재부팅을 하게 되는데, Docker Desktop이 자동 실행된다.

 

 

WSL2 업데이트

아무것도 안 했는데 WSL 업데이트에 실패했다는 경고 창이 뜬다(심장덜컥). 이 경우에는 침착하게 CMD창을 관리자 권한으로 열고 수동으로 WSL을 업데이트해 주면 된다. 명령어는 wsl --update.

 

 

Docker Desktop 재실행

업데이트가 완료되면 docker desktop을 재실행하자.

정상적으로 Docker Desktop이 실행됐다. 위 사진과 같이 메인 화면 왼쪽 하단에 'Engine running' 표시를 확인할 수 있다.

 

 

docker CLI 명령어 실행 확인

CMD 또는 PowerShell을 통해 Docker CLI 명령이 잘 수행되는지도 확인.

C:\Users\user>docker version
Client:
 Version:           28.0.4
 API version:       1.48
 Go version:        go1.23.7
 Git commit:        b8034c0
 Built:             Tue Mar 25 15:07:48 2025
 OS/Arch:           windows/amd64
 Context:           desktop-linux

Server: Docker Desktop 4.40.0 (187762)
 Engine:
  Version:          28.0.4
  API version:      1.48 (minimum version 1.24)
  Go version:       go1.23.7
  Git commit:       6430e49
  Built:            Tue Mar 25 15:07:22 2025
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          1.7.26
  GitCommit:        753481ec61c7c8955a23d6ff7bc8e4daed455734
 runc:
  Version:          1.2.5
  GitCommit:        v1.2.5-0-g59923ef
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0