WSL2에 CUDA 설치하는 방법

WSL2에 CUDA를 설치하는 방법을 다룹니다. 

2022. 11. 26  최초작성

2024. 3. 14

2025. 5. 3 검토

Windows에 WSL2를 설치하는 방법은 아래 포스트를 참고하세요.

WSL2를 설치하여 Ubuntu  사용하는 방법

https://webnautes.com/wsl2reul-seolcihayeo-ubuntu-sayonghaneun-bangbeob/  

아래 링크를 참고하여 작성되었습니다.

https://docs.nvidia.com/cuda/wsl-user-guide/index.html#getting-started-with-cuda-on-wsl 

1. 메뉴에서 cmd를 입력후  명령 프롬프트 위에서 마우스 우클릭하여 보이는 메뉴에서 “관리자 권한으로 실행”을 선택합니다. 

2. 다음 명령으로 wsl을 업데이트합니다. 

wsl.exe --update

3. 아래 스크린샷처럼 이미 최신버전이라는 말대신 업데이트가 이루어졌다면 다음 명령으로 wsl을 강제로 재시작해야 합니다. 

wsl --shutdown

4. wsl을 입력하여 우분트로 모드를 변경합니다. 

5. 현재 GPG key를 삭제합니다. 

sudo apt-key del 7fa2af80

6. 아래 링크에 접속한 후, Linux,  x86_64, WSL-Ubuntu, 2.0, deb(local)을 차례로 선택합니다. 

https://developer.nvidia.com/cuda-downloads

7. 아래쪽에 보이는 다음 내용을 한줄씩 복사하여 실행하여 cuda 설치를 진행합니다. 글 작성시점엔 (2025. 5. 3)  cuda 12.9가 설치됩니다.

웹페이지의 내용을 아래에 가져왔습니다. 

복사후 wsl 창에서 마우스 우클릭하면 붙여넣기가 됩니다.

wget https://developer.download.nvidia.com/compute/cuda/repos/wsl-ubuntu/x86_64/cuda-wsl-ubuntu.pin

sudo mv cuda-wsl-ubuntu.pin /etc/apt/preferences.d/cuda-repository-pin-600

wget https://developer.download.nvidia.com/compute/cuda/12.9.0/local_installers/cuda-repo-wsl-ubuntu-12-9-local_12.9.0-1_amd64.deb

sudo dpkg -i cuda-repo-wsl-ubuntu-12-9-local_12.9.0-1_amd64.deb

sudo cp /var/cuda-repo-wsl-ubuntu-12-9-local/cuda-*-keyring.gpg /usr/share/keyrings/

sudo apt-get update

sudo apt-get -y install cuda-toolkit-12-9

8. 이제 cuDNN을 설치합니다. 

참고 https://dsaint31.tistory.com/entry/ML-WSL2-Install-Tensorflow-GPU 

웹브라우저에서 아래 사이트에 접속합니다. 

https://developer.nvidia.com/cudnn 

회원가입을 이미 했다면 오른쪽 위에 보이는 Join 옆에 있는 아이콘을 클릭합니다.

로그인을 진행합니다.

원래 웹페이지로 돌아오면 왼쪽 Download cuDNN 버튼을 클릭합니다.

스크린샷처럼 선택합니다. 

아래보이는 명령어들을 입력합니다.

wget https://developer.download.nvidia.com/compute/cudnn/9.9.0/local_installers/cudnn-local-repo-ubuntu2404-9.9.0_1.0-1_amd64.deb

sudo dpkg -i cudnn-local-repo-ubuntu2404-9.9.0_1.0-1_amd64.deb

sudo cp /var/cudnn-local-repo-ubuntu2404-9.9.0/cudnn-*-keyring.gpg /usr/share/keyrings/

sudo apt-get update

sudo apt-get -y install cudnn

9. 편집기를 사용하여 .bashrc 파일을 열어서 끝에 다음 한줄을 추가해야 합니다. 

간단히 설명하면

nano 편집기를 사용해서 .bashrc 파일을 열어줍니다.

sudo nano ~/.bashrc

다음 한 줄을 복사한 후, 화살표키로 .bashrc 파일 끝으로 이동한 후, 마우스 우클릭하여 붙여넣기합니다. 

cuda-12.9 부분은 설치한 cuda 버전에 따라 달라져야 합니다.

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/cuda-12.9/lib64/

Ctrl + O를 눌른 후, 엔터를 입력하여 저장한 후, Ctrl + X를 눌려 nano 편집기를 종료합니다.

10. 다음 명령으로 추가한 사항을 환경에 반영합니다.

source ~/.bashrc