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

2022. 11. 26  최초작성

2024. 3. 14

2025. 5. 3 검토

그래픽 카드 드라이버 별로 설치가능한 최대 CUDA 버전이 다르다는 것을 확인했습니다. 진행하기 전에 아래 포스트를 참고해보세요. 우분투에서 확인한 것이지만 결론은 최신버전 CUDA를 설치하려면  최신 버전 그래픽 카드 드라이버를 깔아야 합니다. 

NVIDIA 그래픽카드에서 사용가능한 CUDA 버전 확인하기

https://webnautes.com/nvidia-geuraepigkadeueseo-sayongganeunghan-cuda-beojeon-hwaginhagi/ 

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