RGN 24 - Updated WSL2 Installation Method

Author RAPIDS Ops
Status

Completed

Topic Breaking Change
RAPIDS Version v22.02+
Created 17 February 2022
Updated 05 September 2023

Overview

The installation method for a RAPIDS compatible WSL2 instance has changed with the release of NVIDIA’s WSL2 capable Windows 11 Production Drivers. If you already have RAPIDS running on WSL2, Please update your Windows drivers accordingly for continued EA support with RAPIDS v22.02. If you are installing RAPIDS inside WSL2 for the first time, please follow the updated instructions below:

1. Please follow the steps in this MS Blog to install WSL2: https://docs.microsoft.com/en-us/windows/wsl/install
2. Install the latest Windows 11 production drivers on the host machine, which are WSL2 capable: https://www.nvidia.com/Download/index.aspx?lang=en-us
3. Inside WSL2:
	a. Install conda or docker environments
	b. Install RAPIDS as normal with your environment options of choice.

This makes a complete RAPIDS installation far easier in WSL2. Please do not install any additional NVIDIA drivers, neither GPU nor CUDA, inside your WSL2 instance as it is no longer necessary. CUDA Toolkit (CTK) will be installed when you install RAPIDS in your desired environment.

Status

  • 12-Feb-2022 - EA support continues.

Impact

Users intending to run RAPIDS v22.02+ in WSL2 should update their systems in accordance with this updated installation guide.