기존 WSL 상태 확인 및 초기화

1. 기존 WSL 상태 확인 및 초기화 (삭제)

윈도우 시작 버튼 우클릭 $\rightarrow$ PowerShell (또는 터미널)을 관리자 권한으로 실행합니다.

설치된 배포판 목록 확인

PowerShell

 

wsl --list --verbose

 

(예: Ubuntu 또는 Ubuntu-22.04 등이 출력됩니다.)

기존 배포판 완전 삭제 (초기화)

목록에 나온 이름을 적어 등록을 해제합니다. (Ubuntu 기준)

PowerShell

 

wsl --unregister Ubuntu

주의: 이 명령어를 치면 기존 리눅스 내부 파일이 즉시 전부 삭제되고 깨끗하게 밀립니다. 만약 이름이 Ubuntu-22.04라면 wsl --unregister Ubuntu-22.04를 입력하세요.

2. WSL 커널 업데이트 및 재설치

WSL 최신 커널로 업데이트

PowerShell

 

wsl --update

기본 버전을 2로 고정

PowerShell

 

wsl --set-default-version 2

새로운 Ubuntu 클린 설치

PowerShell

 

wsl --install -d Ubuntu

설치가 진행되면서 잠시 후 새 검은색 리눅스 창이 뜹니다.

• Enter new UNIX username: $\rightarrow$ 사용할 영문 아이디 입력 (예: dev)
• New password: $\rightarrow$ 비밀번호 입력 (화면에 글자가 안 보여도 입력되고 있는 것이니 치고 엔터)
• Retype new password: $\rightarrow$ 비밀번호 한 번 더 입력

dev@컴퓨터이름:~$ 프롬프트가 뜨면 리눅스 클린 설치 완료입니다. 창은 닫으셔도 됩니다.

3. Docker Desktop 연동 확인 (가장 중요)

WSL을 리셋했기 때문에 Docker Desktop이 새 리눅스를 인식하도록 한 번만 체크해 줍니다.

1. 윈도우에서 Docker Desktop 프로그램을 실행합니다.
2. 우측 상단 톱니바퀴(Settings) 아이콘을 클릭합니다.
3. General 탭:
   • Use the WSL 2 based engine 항목이 체크되어 있는지 확인합니다.
4. Resources $\rightarrow$ WSL integration 탭:
   • Enable integration with my default WSL distro 체크
   • 바로 아래 목록에 방금 설치한 Ubuntu 스위치를 ON(활성화)으로 켭니다.
5. 우측 하단 [Apply & restart] 버튼을 누릅니다.

4. 최종 확인

윈도우 PowerShell이나 인텔리제이 터미널에서 아래 명령어를 쳤을 때 정상적으로 출력되면 끝입니다.

PowerShell

 

docker ps

에러 없이 CONTAINER ID IMAGE COMMAND ... 같은 빈 테이블 헤더가 나오면 완벽하게 클린 세팅된 상태입니다.