Use Intel® oneAPI Toolkits on Microsoft* Windows Subsystem for Linux 2 (WSL 2)

ID 674073
Updated 4/3/2023
Version Latest
Public

author-image

By

With Microsoft* Windows Subsystem for Linux 2 (WSL 2), you can use native Linux distribution of Intel® oneAPI tools and libraries on Windows*. 

For more information about WSL, refer to https://docs.microsoft.com/en-us/windows/wsl/about.

Currently, only CPU workflows are supported. Use of Intel oneAPI toolkits on WSL 2 for GPU workflows is not supported yet. However, starting with version 30.0.100.9684, the Intel® Graphics Driver supports WSL 2.

How to Use Intel oneAPI Toolkits on WSL 2 for CPU Workflows

  1. Complete the prerequisites and install WSL 2 as described in https://docs.microsoft.com/en-us/windows/wsl/install-win10:
    • Make sure to use Windows 10 version 2004 and higher (build 19041 and higher) or Windows 11.
    • Follow default installation of WSL 2. If you choose to install manually, make sure that the OS you choose is supported by the oneAPI tool or toolkit you are going to use.  
    • Refer to https://docs.microsoft.com/en-us/windows/wsl/setup/environment for additional best practices.
  2. Launch WSL 2 and install Intel oneAPI toolkit(s):
    • Follow the installation instructions in the Intel oneAPI Toolkits Installation Guide for Linux* OS.
    • Based on chosen OS, you may need to install additional packages for oneAPI toolkits with the following commands:
      • GUI installer:
        $ apt install x11-apps

         

      • Command-line installer on Debian-based OS:
        $ apt install ncurses-term export TERM=xterm-color
         

Known Limitations:

  • Intel® VTune Profiler,  Intel® Advisor, and the Intel® oneAPI Collective Communications Library do not support WSL2.