[Docker | wsl] wslregisterdistribution failed with error: 0x80004002 에러 해결하기 & wsl 설치 삽질기

 

윈도우 Docker를 설치하기 위해 power shell(관리자)에서 wsl 설치를 진행했으나 해당 에러를 마주쳤다.

PS C:\WINDOWS\system32> wsl --install
...
wslregisterdistribution failed with error: 0x80004002
Error: 0x80004002 WSL 2? ?? ?? ?? ????? ?????
Press any key to continue...

 

구글링해보니 에러가 발생하는 원인은 Linux용 Windows 하위 시스템의 선택적 기능이 활성화되지 않았기 때문인 듯 하다. 여튼 그래서 구글링으로 한 천사분의 깃허브 커뮤니티를 통해 이 에러를 해결할 수 있었다.

 

우선 power shell을 관리자 모드로 실행한 뒤, 아래의 커맨드를 실행한다. 그러면 아래와 같은 결과가 출력되면 된다.

PS C:\WINDOWS\system32> Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

// 실행 결과
Path          : 
Online        : True
RestartNeeded : False

참고로 나는 이 커맨드를 실행한 이후 컴퓨터를 다시 시작해야 했고, 이후 다시 실행했을 때 출력이 잘 되었다. 

 

그리고 다시 wsl을 설치하려 했더니...

PS C:\WINDOWS\system32> wsl --install

installing. this may take a few minutes...
please create a default unix user account. the username does not need to match your windows username.
For more information visit: https://aka.ms/wslusers
Enter new UNIX username: naori // username 입력
New password: // password 입력
Retype new password: // password 재입력
passwd: password updated successfully
Installation successful

이번에는 unix 유저 계정을 새로 만들어야 한다고 한다. (아마 wsl이 Linux용 Windows 하위 시스템이란 뜻이니까 wsl을 사용하기 위해선 unix 계정이 따로 필요한 듯 하다)

참고로 처음엔 username을 root로 설정하려고 했으니 이미 존재하는 유저라고 해서 다른 이름으로 설정했다. (굳이 실명이나 윈도우 유저 이름으로 입력하지 않아도 되고, 원하는 이름으로 입력하면 된다)

 

unix 유저 계정까지 성공적으로 만든 이후엔 wsl이 성공적으로 설치가 되었을 것이다.

아래와 같이 설치 및 버전 확인을 해준다.

PS C:\WINDOWS\system32> wsl -l -v

NAME                   STATE           VERSION
* Ubuntu               Running         2

 

위처럼 내역이 뜬다면 성공적으로 wsl이 설치되었고, 만약 version이 2가 아니라면 아래처럼 버전 설정을 해준다.

PS C:\WINDOWS\system32> wsl --set-default-version 2

 

 

이로써 Docker를 설치하기 위해 필요한 wsl 설치를 완료했다.

 

노트북에서 설치할 때는 이런 에러없이 잘만 설치가 됐는데 데스크탑에선 처음 보는 에러에 당황했다.. 하지만 구글링으로 열심히 천사분들의 도움으로 해결해나갈 수 있었고, 다른 분도 이 글을 통해 도움이 됐으면 한다 💕

 

참고 사이트

윈도우 Docker 설치 완벽 가이드(Home 포함)

WSL Ubuntu error 0x80004002 · Issue #2851 · microsoft/WSL

Windows 10에서 WSL2를 이용하여 Ubuntu 설치하는 방법