Windows WSL2 환경에서 Docker 사용하기

By | 2025년 3월 18일
Table of Contents

Windows WSL2 환경에서 Docker 사용하기

WSL2 설치 및 설정

WSL2 활성화

cmd 혹은 PowerShell을 관리자 권한으로 열고 다음 명령을 실행하여 WSL과 가상화를 활성화합니다.

# WSL 활성화
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# WSL2 활성화
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

완료 후 컴퓨터를 재부팅합니다.

WSL2 기본 버전 설정

기본 WSL 버전을 WSL2로 설정하려면 다음 명령을 실행하세요

wsl --set-default-version 2

Linux 배포판 설치

참조

# wsl --list --online
# wsl --install --distribution Ubuntu
wsl --install
exit
wsl --set-default-version 2

wsl -l -v
---------------------
  NAME                   STATE           VERSION
* docker-desktop         Running         2
  docker-desktop-data    Running         2
  Ubuntu                 Stopped         2

Docker Desktop 설치

Docker와 WSL 통합 활성화

Docker Desktop에서 WSL2 Linux 배포판과 통합되도록 설정합니다:

  • Docker Desktop 실행 후, 오른쪽 상단의 톱니바퀴 아이콘(설정)을 클릭합니다.
  • "Resources" -> "WSL Integration" 메뉴로 이동합니다.
  • Docker와 통합할 WSL2 배포판(Ubuntu 등)을 선택하고 "Apply & Restart"를 클릭합니다.

WSL2에서 Docker 사용 확인

  • WSL2 터미널(Ubuntu 등)을 열고 아래 명령어로 Docker가 정상적으로 동작하는지 확인합니다.
docker --version
  • Docker의 hello-world 이미지를 실행하여 제대로 설정되었는지 테스트합니다.
docker run hello-world

답글 남기기