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

ID 674073
Updated 4/3/2023
Version Latest



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

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, 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
    • 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 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.