[WSL] Install WSL (Windows Subsystem for Linux)

[WSL] Install WSL

Pre-requirements.

• windows 10 이상 : ( version 2004 , build 19041 이상이어야 함.)
• windows 11 권장 : ( gpu 기능 등 가능... )
• Tensorflow나 Pytorch등에서 GPU가속을 제대로 쓰려면, build 20150 이상은 되어야 함 (GPGPU가 없는 경우엔 상관없으니 pass)

다음은 GPU 관련 자료임:

2022.07.17 - [Computer/CUDA] - [ML] WSL2 : Install Tensorflow (GPU)

[ML] WSL2 : Install Tensorflow (GPU)

---

다음은 MS의 공식 문서임:

https://learn.microsoft.com/en-us/windows/wsl/install

Install WSL

---

 

---

참고: 최신 내용

2026.1 현재 가장 권장되는 설치 방식은 winget과 wsl --install을 이용하는 방식임.

https://ds31x.tistory.com/585

WSL 을 winget으로 설치 및 제거하기

---

Windows 버전확인.

• windows키 + R 누르고 winver 입력
  
  
• 버전 등을 확인하고 확인 클릭
  
  

---

WSL완전제거 (필요시)

https://ds31x.tistory.com/386

[CE] WSL 완전제거하기

---

Install WSL.

1. Windows 관련 기능 활성화 (관리자 권한 필요):
   1. 제어판 > 프로그램 및 기능 > Windows 기능 켜기/끄기로 이동.
   2. "Windows Subsystem for Linux"와 "Virtual Machine Platform" 등을 체크.
      • "Windows Subsystem for Linux" = Linux용 Windows 하위시스템
      • "Virtual Machine Platform" = 가상 머신 플랫폼
   3. 확인을 누르고 컴퓨터를 reboot.
2. cmd or wt를 관리자모드로 실행. (Powershell을 사용해도 됨. )
   1. 커맨드 프롬프트 (cmd) 에서 설치 또는 Powershell에서 설치.
   2. windows키 + r을 누르고 cmd라고 치면, 커맨드 프롬프트(=터미널)이 수행됨.
3. cmd(command rompt)에서 다음을 입력.
   wsl --install
   • 특정 distribution을 지정하여 설치하려면 다음과 같음.
     wsl --install -d <distribution>
   • 18.04로 설치한다면 다음과 같음.
     wsl --install -d ubuntu-18.04
   • online에서 설치 가능한 배포판 확인하려면 다음을 입력.
     wsl --list --online
     참고로, Microsoft store에서 찾는 게 설명이 보다 자세함.
4. 이후 알아서 설치가 됨.
   • 기본으로 설치되는 배포판(Ubuntu)의 username, password를 설정하는 과정이 포함됨.
   • 가급적 암호를 잊지 않도록 주의할 것.

---

문제가 발생할 경우 다음을 참고

위의 순서대로 했는데도 다음의 에러들이 발생할 수 있음.

error code: 0x8004032d 또는 0x8000000d

이 경우,

1. windows키 + R누르고 optional features 를 입력하고 엔터를 눌러 Windows 기능 켜기/끄기를 실행하고,
2.  다음 그림처럼 Linux용 Windows 하위시스템 이 클릭되어 있는지 확인할 것.
3.  이후 시스템을 재부팅하고 wsl --install 등을 다시 시도해볼 것.)

 

이 외의 에러는 아래로 내려가서 에러 코드에 해당하는 페이지의 지시를 따를 것.

---

WSL 실행하기.

1. 설치 이후 버전 확인
   wsl -l -v
   
   
   • asterisk, * 가 붙은 것이 기본으로 수행되는 distribution임
     (bash등으로 실행 배포판을 지정하지 않은 경우 기본으로 수행되는 distribution이 된다.)
   • VERSION이 2여야 GUI 및 CUDA 등을 사용 가능해짐.
   • wsl --update 를 수행할 것. (←version2로 올림)
2. 특정 배포판 지정하여 실행
   (가운데 있는 ~의 위치에 셀이 시작되는 경로를 지정한다. ~는 default 유저의 home directory를 의미함.).
   wsl ~ -d [Distribution]
   • 그냥 기본으로 지정된 배포판 실행은 bash or wsl임 (wsl 권장).

---

Ubuntu 또는 Debian을 설치하길 권함 : 가장 널리 쓰이기 때문에 이후 패키지들의 설치가 원활함.
Ubuntu 실행 후, sudo apt-get update 와 sudo apt-get upgrade 수행할 것.

---

wsl 의 Shell 에서도 wsl 명령어(window terminal에서 쓰던)를 사용가능함.
단, wsl.exe로 수행해야 함.

 

WSL의 사용법은 다음을 참고할 것.

https://ds31x.tistory.com/67

[Env] WSL 기본 명령어 정리.

---

설치도중 Error에 대한 해결책

Error code : 0x800701bc

아래의 url로 해도 되지만, 더 아래에 있는 0x8004032d의 경우로 해도 되는 경우 있음.

https://ds31x.tistory.com/76

[Error] WSL 설치 관련

---

Error code : 0x80370102

https://ds31x.tistory.com/77

[Error] WSL : Error: 0x80370102

---

Error code : 0x8004032d 또는 0x8000000d

https://ds31x.tistory.com/323

[Error] WSL: 0x8004032d / 0x800000d

---

root 계정으로만 로그인 되는 경우.

https://ds31x.tistory.com/102

[WSL] root계정으로만 로그인 되는 경우.

 

---

References

https://learn.microsoft.com/ko-kr/windows/wsl/install

WSL 설치

https://devblogs.microsoft.com/commandline/install-wsl-with-a-single-command-now-available-in-windows-10-version-2004-and-higher/

Install WSL with a single command now available in Windows 10 version 2004 and higher

 

https://dsaint31.tistory.com/423

[CE] Introduction of WSL

---

https://ds31x.tistory.com/585

WSL 을 winget으로 설치 및 제거하기

 

https://ds31x.tistory.com/586

WSL (WSL2 포함) 정리

---