Windows에서 Docker Desktop 설치하기

Windows 환경에서 Docker Desktop을 설치하고, WSL2(Ubuntu)까지 연동하는 과정을 정리했습니다.

Docker Desktop 설치 파일 다운로드

• Docker 공식 홈페이지에 접속합니다.
• Windows 버전에 맞는 Docker Desktop 설치 파일을 다운로드합니다.

Docker: Accelerated Container Application Development

 

Docker Desktop 설치 진행

설치 파일을 실행하면 Configuration 화면이 나옵니다. 아래 설정을 참고해 선택합니다.

항목설명추천 설정비고

목록	설명
Use WSL 2 instead of Hyper-V	Docker가 WSL2 기반으로 동작하게 설정합니다.
Allow Windows Containers	Windows 전용 컨테이너 사용 여부를 설정합니다.
Add shortcut to desktop	바탕화면에 Docker 아이콘을 추가합니다.

설정을 완료한 후 OK를 눌러 설치를 진행합니다.

 

설치 중 발생할 수 있는 에러와 해결 방법

설치 과정 중 다음 에러가 발생할 수 있습니다.

 

 

해결 방법

• Windows 검색창에 "Windows 기능 켜기/끄기"를 입력해 실행합니다.
• 다음 항목을 활성화합니다.
  • 가상 머신 플랫폼 (Virtual Machine Platform)
  • Linux용 Windows 하위 시스템 (Windows Subsystem for Linux)
• 설정을 적용한 뒤 컴퓨터를 재부팅하시고 다시 설치해 주시면 됩니다.

 

Docker Desktop 설치 마무리

Windows 기능을 활성화하고 재부팅한 뒤, Docker Desktop 설치를 다시 진행합니다.

• 설치 완료 후 "Use recommended settings"(권장 설정 사용)을 선택합니다.
• Finish 버튼을 클릭합니다.

설정이 완료되면 Docker Subscription Service Agreement(라이선스 약관) 화면이 나옵니다.

• 약관을 읽고 Accept 버튼을 눌러 동의합니다.

이 과정을 거치면 Docker Desktop 기본 설치가 끝납니다.

 

WSL2 설치 및 Ubuntu 설치

WSL2가 설치되지 않았다면 PowerShell(관리자 권한)에서 다음 명령어를 실행합니다.

wsl --install -d Ubuntu

명령어를 입력하면 Ubuntu 다운로드 및 설치가 자동으로 진행됩니다. 설치 중 UNIX 사용자 이름을 설정해야 합니다.
이름은 반드시 소문자와 숫자만 사용합니다. 대문자나 특수문자는 허용되지 않습니다.

설치가 완료되면 Ubuntu 기본 환경이 준비됩니다.

 

설치 후 WSL2로 버전 변경

Ubuntu를 설치했더라도 기본 설정이 WSL1일 수 있습니다. 이 경우 버전을 변경해야 합니다.

1. 현재 설치된 WSL 목록과 버전을 확인합니다.

wsl --list --verbose

1. Ubuntu가 VERSION 1로 설정돼 있다면, 다음 명령어로 버전을 변경합니다.

wsl --set-version Ubuntu 2

버전 변경은 몇 분 정도 소요될 수 있습니다.

완료되면 다시 wsl --list --verbose로 확인해 Ubuntu가 VERSION 2로 표시되는지 확인합니다.

 

 

Docker 설치 재진행 및 연동 확인

Ubuntu를 WSL2로 변환한 후 Docker Desktop 설치를 마저 진행합니다.

Use recommended settings(권장 설정 사용)을 선택하고 Finish를 눌러 설치를 완료합니다.

설치가 끝나면 Docker Desktop이 자동으로 실행되며 Docker Engine을 시작합니다.

설치 확인은 다음과 같이 합니다.

 

docker version

Client와 Server 정보가 정상적으로 표시되면 Docker가 제대로 설치된 것입니다.