Introduction
The Intel® oneAPI Rendering Toolkit contains a set of rendering and ray-tracing libraries that are designed to help you transform detailed or raw datasets into rich, realistic visuals. The libraries are optimized for the continuum of visualization needs. For the release notes and issues associated with the toolkit, please refer to the Release Notes page.
Intel® oneAPI Rendering Toolkit includes the following components:
- Raytracing Libraries
- Development Showcase Application
- Kernel Optimizing Compiler
- Intel® Implicit SPMD Program Compiler (Intel® ISPC)
- ISPCRT runtime
- Intel® Implicit SPMD Program Compiler (Intel® ISPC)
-
- rkUtil superbuild CMake script
- Internal 3D math and tasking library
- Intel® rkCommon library
Components distributed elsewhere:
- Rendering Framework Plugin
- OpenGL*-compatible software rasterizer (Mesa Gallium)
Version History
| Date | Version | Major Change Summary |
| September 2023 | 2023.2.1 | OIDN 2 GPU fix, components rebuilt with 2023.2.2 Intel® oneAPI DPC++ compiler |
| July 2023 | 2023.2.0 | OIDN 2 included by missing GPU support, please use 2023.2.1 |
| May 2023 | 2023.1.1 | Hotfix for Embree |
| March 2023 | 2023.1 | Beta Discrete GPU support added for Embree. Added Open PGL. |
| December 2022 | 2023.0 | No component updates from 2022.3.1 |
| September 2022 | 2022.3.1 | Hotfix release |
| September 2022 | 2022.3 | OIDN no change. All other components updated |
| April 2022 | 2022.2 | ISPCRT added. Updates: All components updated |
| December 2021 | 2022.1 | ISPC added. Updates: All libraries updated |
Intel oneAPI Rendering Toolkit 2023.2.1
Intel® oneAPI 2023.2.1 fixes GPU support for OIDN and rebuilds other components. See 2023.2.0 for system requirements.
Intel oneAPI Rendering Toolkit 2023.2.0
Intel® oneAPI 2023.2 is validated on Windows, Linux, and macOS.
Windows Intel® Graphics Driver
To install the driver follow the directions in the article appropriate for your device
- Intel® Arc™ A-Series Graphics (DG2)
- Intel® Data Center GPU Flex Series (ATS-M)
- Contact your OEM representative for access to the Intel Registration Center.
- Intel® processor graphics Gen12, Intel® Iris Xe MAX(codename DG1) devices are functional with Intel® Open Image Denoise.
Linux General Purpose Intel GPUs (GPGPU) Driver
For all Intel GPUs, see this article, https://dgpu-docs.intel.com/, and follow the directions for your client or data center class device.
Supported Host Operating Systems
NOTE: The following distributions are supported by most components. These OS distributions are tested by Intel or known to work; other distributions may or may not work and are not recommended. If you have questions, access the Intel Community Forums when you need assistance. If you have Commercial Support, create a support ticket.
Linux* CPU Host
- Ubuntu* LTS 22.04, 20.04
- Rocky* Linux 8, 9
- Red Hat* Enterprise Linux* (RHEL*) 8, 9
- SUSE Linux Enterprise Server* (SLES) 15 SP3, SP4
- Fedora* 37
- Debian* 9, 10, 11
- Amazon 2, 2022
- WSL 2
Linux* discrete GPU Host (Xe-HPG or Xe-HPC architectures and higher)
NOTE: As of 2023.2, only the Embree and OIDN library components have discrete GPU support. Embree does not support Intel® processor graphics Gen12, Intel® Iris Xe MAX(codename DG1) devices.
- Ubuntu* LTS 22.04, 20.04
- Intel® Arc™ A-Series Graphics, Intel® Data Center GPU Flex Series
- Red Hat* Enterprise Linux* (RHEL*) 8.5
- Intel® Data Center GPU Flex Series
- Red Hat* Enterprise Linux* (RHEL*) 8.6
- Intel® Data Center GPU MAX Series, Intel® Data Center GPU Flex Series
- SUSE Linux Enterprise Server* (SLES) 15 SP3, SP4
- Intel® Data Center GPU MAX Series
Updates to OS and driver support for discrete GPU are occurring rapidly. Please see https://dgpu-docs.intel.com/ for OS support updates. To target discrete GPU, a compatible discrete GPU device is currently required both at client program build-time and at run-time. Intel® processor graphics Gen12, Intel® Iris Xe MAX(codename DG1) devices are not compatible with Render Kit.
Windows* CPU/GPU Host
- Windows* 10
- Windows* 11
- Windows* Server 2019, 2022
- Using Microsoft’s Windows Subsystem for Linux 2 (WSL2) in Windows 10 and Windows 11, you can install the native Linux distribution of Intel oneAPI toolkits and libraries on Windows for CPU and GPU workflows: Details.
macOS* CPU Only Host
- Intel® 64 based systems:
- macOS* 12.0 Monterey
- macOS* 13.0
- Apple* M1 based systems:
- macOS* 12.0 Monterey or higher
Supported Target Operating Systems
NOTE: The following distributions are supported by most components. These OS distributions are tested by Intel or known to work; other distributions may or may not work and are not recommended. If you have questions, access the Intel Community Forums when you need assistance. If you have Commercial Support, create a support ticket.
Linux CPU Target
- Ubuntu* LTS 22.04, 20.04
- Rocky* Linux 8, 9
- Red Hat* Enterprise Linux* (RHEL*) 8, 9
- SUSE Linux Enterprise Server* (SLES) 15 SP3, SP4
- Fedora* 36,37
- Debian* 9, 10, 11
- Amazon 2, 2022
- WSL 2
Linux* discrete GPU Target (Xe-HPG or Xe-HPC architectures and higher)
NOTE: As of 2023.2, only the Embree and OIDN library components have discrete GPU support. Embree does not support Intel® processor graphics Gen12, Intel® Iris Xe MAX(codename DG1) devices.
- Ubuntu* LTS 22.04, 20.04
- Intel® Arc™ A-Series Graphics, Intel® Data Center GPU Flex Series
- Red Hat* Enterprise Linux* (RHEL*) 8.5
- Intel® Data Center GPU Flex Series
- Red Hat* Enterprise Linux* (RHEL*) 8.6
- Intel® Data Center GPU MAX Series, Intel® Data Center GPU Flex Series
- SUSE Linux Enterprise Server* (SLES) 15 SP3, SP4
- Intel® Data Center GPU MAX Series
Updates to OS and driver support for discrete GPU are occurring rapidly. Please see https://dgpu-docs.intel.com/ for OS support updates. To target discrete GPU, a compatible discrete GPU device is currently required both at client program build-time and at run-time. Intel® processor graphics Gen12, Intel® Iris Xe MAX(codename DG1) devices are not compatible with Render Kit.
Windows CPU/GPU Target
- Windows* 10
- Windows* 11
- Windows* Server 2022
- Using Microsoft’s Windows Subsystem for Linux 2 (WSL2) in Windows 10 and Windows 11, you can install the native Linux distribution of Intel oneAPI toolkits and libraries on Windows for CPU and GPU workflows: Details.
macOS* CPU Target
- Intel® 64 based systems:
- macOS* 12.0 Monterey
- macOS* 13.0
- Apple* M1 based systems:
- macOS* 12.0 Monterey or higher
Windows Space Requirements by Component
NOTE: Components additionally require space of automatically included prerequisite components, such as Intel® Threading Building Blocks (Intel® oneTBB)
| Component | Approximate Disk Space |
| Intel Embree | 100 MB |
| Intel Open Image Denoise | 50 MB |
| Intel OpenSWR | Binaries are not provided. |
| Intel Open VKL | 30 MB |
| Intel OSPRay | 20 MB |
| Intel OSPRay Studio | <10 MB |
| Intel rkcommon library | 10 MB |
| Intel rkUtil superbuild | <1 MB |
| Intel Implicit SPMD Program Compiler | 75MB |
| Automatic Base Toolkit Component | |
| Intel® oneTBB | 500MB |
| All Components | 1.1 GB |
Supported Target Hardware Platforms
The following platforms are supported by most software components.
NOTE: Intel® 64 hardware platforms must support at least Intel® Streaming SIMD Extensions 4.2. Full software optimization is implemented for Intel® Advanced Vector Extensions 512. See ark.intel.com to search device capabilities.
- Intel® 64
- Intel Atom® processors
- Intel® Core™ processor family
- Intel® Xeon® processor family
- Intel® Xeon® Scalable processor family
- ARM
- Apple* M1
- Xe-HPG or Xe-HPC architectures and higher (Embree and OIDN libraries)
- Intel® Arc™ A-Series Graphics
- Intel® Data Center GPU MAX Series
- Intel® Data Center GPU Flex Series
- Xe-LP architectures and higher (OIDN library only)
Software Requirements
Prerequisites by Component
Intel® Embree Prerequisites
- Intel oneTBB version 2021.9 or higher (installed automatically with toolkit)
- Intel rkcommon library version 1.11.0 (installed automatically with toolkit)
- Discrete GPU support: Intel® oneAPI DPC++/C++ Compiler found in the Base Kit (explained in toolkit configuration instructions)
- Optional: Intel® Implicit SPMD Program Compiler (Intel® ISPC) version 1.20.0 or higher (included)
Intel® Open VKL Prerequisites
- Optional: OpenGL* to run the example viewer
- Intel rkcommon library version 1.11.0 or higher (included)
- Intel oneTBB version 2021.9 or higher (installed automatically from toolkit)
- Intel Embree version 4.1.0-beta or higher (included)
Intel® Open Image Denoise PRerequisites
- Intel oneTBB version 2021.9 or higher (installed automatically from toolkit)
Intel® OSPRay Prerequisites
- Intel oneTBB version 2021.9 or higher (installed automatically from toolkit)
- Intel Embree version 4.1.0-beta or higher (included)
- Intel rkcommon library version 1.11.0 (included)
- Intel Open VKL version 1.3.2 (included)
- Optional: OpenGL* to run the example viewer
- Linux* Only: Intel ISPC Runtime version 1.20.0 and its dependencies (included)
Intel® OpenPGL Prerequisites
- Intel oneTBB version 2021.9 or higher (installed automatically from toolkit)
Intel® OSPRay Studio
- Intel® OSPRay 2.12.0 and its dependencies (included)
- OpenGL* and GLFW3 for Windowed mode (non-batch mode)
- Optional: OpenImageIO* 2.x, OpenEXR* (IlmBase) for extended texture support
- Optional: Python 3.9.7 for python binding support
Intel® oneAPI Rendering Toolkit rkCommon library
- Intel oneTBB version 2021.9 or higher (installed automatically from toolkit)
Intel® Implicit SPMD Program Compiler (Intel® ISPC)
- None
Intel® oneAPI Rendering Toolkit rkUtil superbuild script
- CMake* 3.15 or higher
- Internet connection
- Brings in popular core prerequisites as needed
- Brings in most optional prerequisites as needed
Intel® OpenSWR Prerequisites
NOTE: Intel OpenSWR is available as part of the Mesa* OpenGL* open source community project at www.mesa3d.org. Please see Mesa owned guidance for build and deployment information.
- Intel OpenSWR is built as a gallium driver within Mesa* 3D Graphics Library. For Intel OpenSWR build prerequisites and instructions, refer to the Intel OpenSWR website. The meson based build path is typically preferred.
Development Environment
All supported platforms
- C++17 or higher compiler is recommended.
- C++11 or higher compiler for client applications. C++14 or higher for superbuild, for building OSPRay Studio, and preferred for using typical third party libraries.
- For compatibility with the Intel® oneAPI DPC++ C/C++ Compiler use C++17 or higher (available with GCC-7 or higher).
- C99 or higher compiler.
Microsoft Visual Studio*
- Microsoft Visual Studio* 2019 or higher is recommended
Intel oneAPI Rendering Toolkit 2023.1
Intel® oneAPI 2023.1 is validated on Windows and Linux.
Windows Intel® Graphics Driver
To install the driver follow the directions in the article appropriate for your device
- Intel® Arc™ A-Series Graphics (DG2)
- Intel® Data Center GPU Flex Series (ATS-M)
- Contact your OEM representative for access to the Intel Registration Center.
- Intel® processor graphics Gen12, Intel® Iris Xe MAX(codename DG1) devices are not compatible with Render Kit.
Linux General Purpose Intel GPUs (GPGPU) Driver
For all Intel GPUs, see this article, https://dgpu-docs.intel.com/, and follow the directions for your device.
Supported Host Operating Systems
NOTE: The following distributions are supported by most components. These OS distributions are tested by Intel or known to work; other distributions may or may not work and are not recommended. If you have questions, access the Intel Community Forums when you need assistance. If you have Commercial Support, create a support ticket.
Linux* CPU Host
- Ubuntu* LTS 22.04, 20.04
- Rocky* Linux 8, 9
- Red Hat* Enterprise Linux* (RHEL*) 8, 9
- SUSE Linux Enterprise Server* (SLES) 15 SP3, SP4
- Fedora* 36,37
- Debian* 9, 10, 11
- Amazon 2, 2022
- WSL 2
Linux* GPU Host (Xe-HPG or Xe-HPC architectures and higher)
NOTE: As of 2023.1, only the Embree library component has discrete GPU support.
- Ubuntu* LTS 22.04, 20.04
- Intel® Arc™ A-Series Graphics, Intel® Data Center GPU Flex Series
- Red Hat* Enterprise Linux* (RHEL*) 8.5
- Intel® Data Center GPU Flex Series
- Red Hat* Enterprise Linux* (RHEL*) 8.6
- Intel® Data Center GPU MAX Series, Intel® Data Center GPU Flex Series
- SUSE Linux Enterprise Server* (SLES) 15 SP3, SP4
- Intel® Data Center GPU MAX Series
Updates to OS and driver support for discrete GPU are occurring rapidly. Please see https://dgpu-docs.intel.com/ for OS support updates. To target discrete GPU, a compatible discrete GPU device is currently required both at client program build-time and at run-time. Intel® processor graphics Gen12, Intel® Iris Xe MAX(codename DG1) devices are not compatible with Render Kit.
Known Issues
GPU offload applications using extensive multi-threading (>2 threads) may experience hangs or time out which can be recovered only though a hard reset or power cycling of the system for the following Linux Distributions. The issue occurs when reading/writing data to the Intel GPU while making extensive use of multi-threading due to a defect in older Linux kernels.
| Kernel/Distribution | Problem Occurs | Problem Does Not Occur |
| RedHat Enterprise Linux | RHEL 8.4 (kernel 4.18.0-305) and older | RHEL 8.5 (kernel 4.18.0-348) |
| SUSE Linux | SLES15 SP3 and older | SLES15 SP4 beta |
| Ubuntu Linux | Ubuntu releases older than 20.04.03 | Ubuntu 20.04.03 (kernel 5.11.0-40-generic #44~20.04.2-ubuntu)* |
Workaround
- Preferred: Upgrade to a Linux distribution where the defect has been fixed. Note that the software will run, but a warning message will appear in kernel logs.
- GPU software for Ubuntu 20.04.03 is available now via https://dgpu-docs.intel.com. Note that the software will run, but a warning message will appear in kernel logs. GPU software for RHEL 8.5. will be available in Q1 2022 at the same location. GPU software for SLES15 SP4 will be available shortly after general availability of SLES15 SP4.
- Alternative: Do not use extensive multi-threading in GPU-enabled applications, i.e. keep the number of threads no more than 2. For example, for applications using the oneAPI MPI library, use the single threaded version of the MPI run-time library, rather than the multi-threaded version. Set the environment variable I_MPI_THREAD_SPLIT=0 to use the single threaded version of MPI.
Windows* CPU/GPU Host
- Windows* 10
- Windows* 11
- Windows* Server 2019, 2022
- Using Microsoft’s Windows Subsystem for Linux 2 (WSL2) in Windows 10 and Windows 11, you can install the native Linux distribution of Intel oneAPI toolkits and libraries on Windows for CPU and GPU workflows: Details.
macOS* CPU Only Host
- Intel® 64 based systems:
- macOS* 12.0 Monterey
- macOS* 13.0
- Apple* M1 based systems:
- macOS* 12.0 Monterey or higher
Supported Target Operating Systems
NOTE: The following distributions are supported by most components. These OS distributions are tested by Intel or known to work; other distributions may or may not work and are not recommended. If you have questions, access the Intel Community Forums when you need assistance. If you have Commercial Support, create a support ticket.
Linux CPU Target
- Ubuntu* LTS 22.04, 20.04
- Rocky* Linux 8, 9
- Red Hat* Enterprise Linux* (RHEL*) 8, 9
- SUSE Linux Enterprise Server* (SLES) 15 SP3, SP4
- Fedora* 36,37
- Debian* 9, 10, 11
- Amazon 2, 2022
- WSL 2
Linux* GPU Target (Xe-HPG or Xe-HPC architectures and higher)
NOTE: As of 2023.1, only the Embree library component has discrete GPU support.
- Ubuntu* LTS 22.04, 20.04
- Intel® Arc™ A-Series Graphics, Intel® Data Center GPU Flex Series
- Red Hat* Enterprise Linux* (RHEL*) 8.5
- Intel® Data Center GPU Flex Series
- Red Hat* Enterprise Linux* (RHEL*) 8.6
- Intel® Data Center GPU MAX Series, Intel® Data Center GPU Flex Series
- SUSE Linux Enterprise Server* (SLES) 15 SP3, SP4
- Intel® Data Center GPU MAX Series
Updates to OS and driver support for discrete GPU are occurring rapidly. Please see https://dgpu-docs.intel.com/ for OS support updates. To target discrete GPU, a compatible discrete GPU device is currently required both at client program build-time and at run-time. Intel® processor graphics Gen12, Intel® Iris Xe MAX(codename DG1) devices are not compatible with Render Kit.
Known Issues
GPU offload applications using extensive multi-threading (>2 threads) may experience hangs or time out which can be recovered only though a hard reset or power cycling of the system for the following Linux Distributions. The issue occurs when reading/writing data to the Intel GPU while making extensive use of multi-threading due to a defect in older Linux kernels.
| Kernel/Distribution | Problem Occurs | Problem Does Not Occur |
| RedHat Enterprise Linux | RHEL 8.4 (kernel 4.18.0-305) and older | RHEL 8.5 (kernel 4.18.0-348) |
| SUSE Linux | SLES15 SP3 and older | SLES15 SP4 beta |
| Ubuntu Linux | Ubuntu releases older than 20.04.03 | Ubuntu 20.04.03 (kernel 5.11.0-40-generic #44~20.04.2-ubuntu)* |
Workaround
- Preferred: Upgrade to a Linux distribution where the defect has been fixed. Note that the software will run, but a warning message will appear in kernel logs.
- GPU software for Ubuntu 20.04.03 is available now via https://dgpu-docs.intel.com. Note that the software will run, but a warning message will appear in kernel logs. GPU software for RHEL 8.5. will be available in Q1 2022 at the same location. GPU software for SLES15 SP4 will be available shortly after general availability of SLES15 SP4.
- Alternative: Do not use extensive multi-threading in GPU-enabled applications, i.e. keep the number of threads no more than 2. For example, for applications using the oneAPI MPI library, use the single threaded version of the MPI run-time library, rather than the multi-threaded version. Set the environment variable I_MPI_THREAD_SPLIT=0 to use the single threaded version of MPI.
Windows CPU/GPU Target
- Windows* 10
- Windows* 11
- Windows* Server 2022
- Using Microsoft’s Windows Subsystem for Linux 2 (WSL2) in Windows 10 and Windows 11, you can install the native Linux distribution of Intel oneAPI toolkits and libraries on Windows for CPU and GPU workflows: Details.
macOS* CPU Target
- Intel® 64 based systems:
- macOS* 12.0 Monterey
- macOS* 13.0
- Apple* M1 based systems:
- macOS* 12.0 Monterey or higher
Windows Space Requirements by Component
NOTE: Components additionally require space of automatically included prerequisite components, such as Intel® Threading Building Blocks (Intel® oneTBB)
| Component | Approximate Disk Space |
| Intel Embree | 100 MB |
| Intel Open Image Denoise | 50 MB |
| Intel OpenSWR | Binaries are not provided. |
| Intel Open VKL | 30 MB |
| Intel OSPRay | 20 MB |
| Intel OSPRay Studio | <10 MB |
| Intel rkcommon library | 10 MB |
| Intel rkUtil superbuild | <1 MB |
| Intel Implicit SPMD Program Compiler | 75MB |
| Automatic Base Toolkit Component | |
| Intel® oneTBB | 500MB |
| All Components | 1.1 GB |
Supported Target Hardware Platforms
The following platforms are supported by most software components.
NOTE: Intel® 64 hardware platforms must support at least Intel® Streaming SIMD Extensions 4.2. Full software optimization is implemented for Intel® Advanced Vector Extensions 512. See ark.intel.com to search device capabilities.
- Intel® 64
- Intel Atom® processors
- Intel® Core™ processor family
- Intel® Xeon® processor family
- Intel® Xeon® Scalable processor family
- ARM
- Apple* M1
- Xe-HPG or Xe-HPC architectures and higher (Embree Only)
- Intel® Arc™ A-Series Graphics
- Intel® Data Center GPU MAX Series
- Intel® Data Center GPU Flex Series
Software Requirements
Prerequisites by Component
Intel® Embree Prerequisites
- Intel oneTBB version 2021.8 or higher (installed automatically with toolkit)
- Intel rkcommon library version 1.11.0 (installed automatically with toolkit)
- Discrete GPU support: Intel® oneAPI DPC++/C++ Compiler found in the Base Kit (explained in toolkit configuration instructions)
- Optional: Intel® Implicit SPMD Program Compiler (Intel® ISPC) version 1.19.0 or higher (included)
Intel® Open VKL Prerequisites
- Optional: OpenGL* to run the example viewer
- Intel rkcommon library version 1.11.0 or higher (included)
- Intel oneTBB version 2021.8 or higher (installed automatically from toolkit)
- Intel Embree version 4.0.1-beta or higher (included)
Intel® Open Image Denoise PRerequisites
- Intel oneTBB version 2021.8 or higher (installed automatically from toolkit)
Intel® OSPRay Prerequisites
- Intel oneTBB version 2021.8 or higher (installed automatically from toolkit)
- Intel Embree version 4.0.1-beta or higher (included)
- Intel rkcommon library version 1.11.0 (included)
- Intel Open VKL version 1.3.2 (included)
- Optional: OpenGL* to run the example viewer
- Linux* Only: Intel ISPC Runtime version 1.19.0 and its dependencies (included)
Intel® OpenPGL Prerequisites
- Intel oneTBB version 2021.8 or higher (installed automatically from toolkit)
Intel® OSPRay Studio
- Intel® OSPRay 2.11.0 and its dependencies (included)
- OpenGL* and GLFW3 for Windowed mode (non-batch mode)
- Optional: OpenImageIO* 2.x, OpenEXR* (IlmBase) for extended texture support
- Optional: Python 3.9.7 for python binding support
Intel® oneAPI Rendering Toolkit rkCommon library
- Intel oneTBB version 2021.8 or higher (installed automatically from toolkit)
Intel® Implicit SPMD Program Compiler (Intel® ISPC)
- Linux* Only: OpenMP* is required by Intel ISPC Runtime version 1.19.0 (explained in toolkit configuration instructions)
Intel® oneAPI Rendering Toolkit rkUtil superbuild script
- CMake* 3.15 or higher
- Internet connection
- Brings in popular core prerequisites as needed
- Brings in most optional prerequisites as needed
Intel® OpenSWR Prerequisites
NOTE: Intel OpenSWR is available as part of the Mesa* OpenGL* open source community project at www.mesa3d.org. Please see Mesa owned guidance for build and deployment information.
- Intel OpenSWR is built as a gallium driver within Mesa* 3D Graphics Library. For Intel OpenSWR build prerequisites and instructions, refer to the Intel OpenSWR website. The meson based build path is typically preferred.
Development Environment
All supported platforms
- C++11 or higher compiler for client applications. C++14 or higher for superbuild, for building OSPRay Studio, and preferred for using typical third party libraries.
- For compatibility with the Intel® oneAPI DPC++ C/C++ Compiler use C++17 or higher (available with GCC-7 or higher).
- C99 or higher compiler.
Microsoft Visual Studio*
- Microsoft Visual Studio* 2019 or higher is recommended
Intel oneAPI Rendering Toolkit 2023.0
Intel® oneAPI 2023.0 is validated on Windows and Linux.
Windows Intel® Graphics Driver
To install the driver follow the directions in the article appropriate for your device
- Intel® Arc™ A-Series Graphics (DG2)
- Intel® Data Center GPU Flex Series (ATS-M)
- https://registrationcenter.intel.com/en/products/subscription/956/
- Contact your OEM representative for access to the Intel Registration Center.
Linux General Purpose Intel GPUs (GPGPU) Driver
For all Intel GPUs, see this article, https://dgpu-docs.intel.com/, and follow the directions for your device.
Supported Host Operating Systems
NOTE: The following distributions are supported by most components. These OS distributions are tested by Intel or known to work; other distributions may or may not work and are not recommended. If you have questions, access the Intel Community Forums when you need assistance. If you have Commercial Support, create a support ticket.
Linux* Host
- Ubuntu* LTS 22.04, 20.04
- Rocky* Linux 8, 9
- Arch Linux*
- Red Hat* Enterprise Linux* (RHEL*) 8, 9
- SUSE Linux Enterprise Server* (SLES) 15 SP3, SP4
- Fedora* 36,37
- Debian* 11
- Amazon 2022
Known Issues
GPU offload applications using extensive multi-threading (>2 threads) may experience hangs or time out which can be recovered only though a hard reset or power cycling of the system for the following Linux Distributions. The issue occurs when reading/writing data to the Intel GPU while making extensive use of multi-threading due to a defect in older Linux kernels.
| Kernel/Distribution | Problem Occurs | Problem Does Not Occur |
| RedHat Enterprise Linux | RHEL 8.4 (kernel 4.18.0-305) and older | RHEL 8.5 (kernel 4.18.0-348) |
| SUSE Linux | SLES15 SP3 and older | SLES15 SP4 beta |
| Ubuntu Linux | Ubuntu releases older than 20.04.03 | Ubuntu 20.04.03 (kernel 5.11.0-40-generic #44~20.04.2-ubuntu)* |
Workaround
- Preferred: Upgrade to a Linux distribution where the defect has been fixed. Note that the software will run, but a warning message will appear in kernel logs.
- GPU software for Ubuntu 20.04.03 is available now via https://dgpu-docs.intel.com. Note that the software will run, but a warning message will appear in kernel logs. GPU software for RHEL 8.5. will be available in Q1 2022 at the same location. GPU software for SLES15 SP4 will be available shortly after general availability of SLES15 SP4.
- Alternative: Do not use extensive multi-threading in GPU-enabled applications, i.e. keep the number of threads no more than 2. For example, for applications using the oneAPI MPI library, use the single threaded version of the MPI run-time library, rather than the multi-threaded version. Set the environment variable I_MPI_THREAD_SPLIT=0 to use the single threaded version of MPI.
Windows* Host
- Windows* 10
- Windows* 11
- Windows* Server 2019, 2022
- Using Microsoft’s Windows Subsystem for Linux 2 (WSL2) in Windows 10 and Windows 11, you can install the native Linux distribution of Intel oneAPI toolkits and libraries on Windows for CPU and GPU workflows: Details.
macOS* Host
- Intel® 64 based systems:
- macOS* 12.0 Monterey
- macOS* 13.0
- Apple* M1 based systems:
- macOS* 12.0 Monterey or higher
Supported Target Operating Systems
NOTE: The following distributions are supported by most components. These OS distributions are tested by Intel or known to work; other distributions may or may not work and are not recommended. If you have questions, access the Intel Community Forums when you need assistance. If you have Commercial Support, create a support ticket.
Linux Target
- Ubuntu* LTS 22.04, 20.04
- Rocky* Linux 8, 9
- Arch Linux*
- Red Hat* Enterprise Linux* (RHEL*) 8, 9
- SUSE Linux Enterprise Server* (SLES) 15 SP3, SP4
- Fedora* 36,37
- Debian* 11
- Amazon 2022
Known Issues
GPU offload applications using extensive multi-threading (>2 threads) may experience hangs or time out which can be recovered only though a hard reset or power cycling of the system for the following Linux Distributions. The issue occurs when reading/writing data to the Intel GPU while making extensive use of multi-threading due to a defect in older Linux kernels.
| Kernel/Distribution | Problem Occurs | Problem Does Not Occur |
| RedHat Enterprise Linux | RHEL 8.4 (kernel 4.18.0-305) and older | RHEL 8.5 (kernel 4.18.0-348) |
| SUSE Linux | SLES15 SP3 and older | SLES15 SP4 beta |
| Ubuntu Linux | Ubuntu releases older than 20.04.03 | Ubuntu 20.04.03 (kernel 5.11.0-40-generic #44~20.04.2-ubuntu)* |
Workaround
- Preferred: Upgrade to a Linux distribution where the defect has been fixed. Note that the software will run, but a warning message will appear in kernel logs.
- GPU software for Ubuntu 20.04.03 is available now via https://dgpu-docs.intel.com. Note that the software will run, but a warning message will appear in kernel logs. GPU software for RHEL 8.5. will be available in Q1 2022 at the same location. GPU software for SLES15 SP4 will be available shortly after general availability of SLES15 SP4.
- Alternative: Do not use extensive multi-threading in GPU-enabled applications, i.e. keep the number of threads no more than 2. For example, for applications using the oneAPI MPI library, use the single threaded version of the MPI run-time library, rather than the multi-threaded version. Set the environment variable I_MPI_THREAD_SPLIT=0 to use the single threaded version of MPI.
Windows Target
- Windows* 10
- Windows* 11
- Windows* Server 2022
- Using Microsoft’s Windows Subsystem for Linux 2 (WSL2) in Windows 10 and Windows 11, you can install the native Linux distribution of Intel oneAPI toolkits and libraries on Windows for CPU and GPU workflows: Details.
macOS* Target
- Intel® 64 based systems:
- macOS* 12.0 Monterey
- macOS* 13.0
- Apple* M1 based systems:
- macOS* 12.0 Monterey or higher
Windows Space Requirements by Component
NOTE: Components additionally require space of automatically included prerequisite components, such as Intel® Threading Building Blocks (Intel® oneTBB)
| Component | Approximate Disk Space |
| Intel Embree | 100 MB |
| Intel Open Image Denoise | 50 MB |
| Intel OpenSWR | Binaries are not provided. |
| Intel Open VKL | 30 MB |
| Intel OSPRay | 20 MB |
| Intel OSPRay Studio | <10 MB |
| Intel rkcommon library | 10 MB |
| Intel rkUtil superbuild | <1 MB |
| Intel Implicit SPMD Program Compiler | 75MB |
| Automatic Base Toolkit Component | |
| Intel® oneTBB | 500MB |
| All Components | 1.1 GB |
Supported Target Hardware Platforms
The following platforms are supported by most software components.
NOTE: Intel® 64 hardware platforms must support at least Intel® Streaming SIMD Extensions 4.2. Full software optimization is implemented for Intel® Advanced Vector Extensions 512. See ark.intel.com to search device capabilities.
- Intel® 64
- Intel Atom® processors
- Intel® Core™ processor family
- Intel® Xeon® processor family
- Intel® Xeon® Scalable processor family
- ARM
- Apple* M1
Software Requirements
Prerequisites by Component
Intel® Embree Prerequisites
- Intel oneTBB version 2021.5.0 or higher (installed automatically with toolkit)
- Intel rkcommon library version 1.10.0 (installed automatically with toolkit)
- Optional: Intel® Implicit SPMD Program Compiler (Intel® ISPC) version 1.18.0 or higher (included)
Intel® Open VKL Prerequisites
- Optional: OpenGL* to run the example viewer
- Intel rkcommon library version 1.10.0 or higher (included)
- Intel oneTBB version 2021.5.0 or higher (installed automatically from toolkit)
- Intel Embree version 3.13.4 or higher (included)
Intel® Open Image Denoise PRerequisites
- Intel oneTBB version 2021.5.0 or higher (installed automatically from toolkit)
Intel® OSPRay Prerequisites
- Intel oneTBB version 2021.5.0 or higher (installed automatically from toolkit)
- Intel Embree version 3.13.4 or higher (included)
- Intel rkcommon library version 1.10.0 (included)
- Intel Open VKL version 1.3.0 (included)
- Optional: OpenGL* to run the example viewer
- Optional: Intel ISPC version 1.18.0 or higher for better performance (included)
Intel® OSPRay Studio
- Intel® OSPRay 2.10.0 and its dependencies (included)
- OpenGL* and GLFW3 for Windowed mode (non-batch mode)
- Optional: OpenImageIO* 2.x, OpenEXR* (IlmBase) for extended texture support
- Optional: Python 3.9.7 for python binding support
Intel® oneAPI Rendering Toolkit rkCommon library
- Intel oneTBB version 2021.5.0 or higher (installed automatically from toolkit)
Intel® Implicit SPMD Program Compiler (Intel® ISPC)
- None (only default system libraries)
Intel® oneAPI Rendering Toolkit rkUtil superbuild script
- CMake* 3.15 or higher
- Internet connection
- Brings in popular core prerequisites as needed
- Brings in most optional prerequisites as needed
Intel® OpenSWR Prerequisites
NOTE: Intel OpenSWR is available as part of the Mesa* OpenGL* open source community project at www.mesa3d.org. Please see Mesa owned guidance for build and deployment information.
- Intel OpenSWR is built as a gallium driver within Mesa* 3D Graphics Library. For Intel OpenSWR build prerequisites and instructions, refer to the Intel OpenSWR website. The meson based build path is typically preferred.
Development Environment
All supported platforms
- C++11 or higher compiler for client applications. C++14 or higher for superbuild, for building OSPRay Studio, and preferred for using typical third party libraries.
- For compatibility with the Intel® oneAPI DPC++ C/C++ Compiler use C++17 or higher (available with GCC-7 or higher).
- C99 or higher compiler.
Microsoft Visual Studio*
- Microsoft Visual Studio* 2019 or higher is recommended
Component System Requirements
| Intel® oneAPI Component System Requirement | Open Source Reference |
| Intel® Embree | All hosts |
| Intel® Open Image Denoise | All hosts |
| Intel® Open VKL | All hosts |
| Intel® Open PGL | All hosts |
| Intel® OSPRay | All hosts |
| Intel® OSPRay Studio | All hosts |
| Intel® Implicit SPMD Program Compiler | All hosts |
Previous oneAPI Releases
2022.x
- Release Notes
- System Requirements
Get Started
Refer to the Intel® oneAPI Rendering Toolkit landing page to find the detailed information and experience the toolkit.
Notices and Disclaimers
Intel technologies may require enabled hardware, software or service activation.
No product or component can be absolutely secure.
Your costs and results may vary.
© Intel Corporation. Intel, the Intel logo, and other Intel marks are trademarks of Intel Corporation or its subsidiaries. Other names and brands may be claimed as the property of others.
No license (express or implied, by estoppel or otherwise) to any intellectual property rights is granted by this document.
The products described may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request.
Intel disclaims all express and implied warranties, including without limitation, the implied warranties of merchantability, fitness for a particular purpose, and non-infringement, as well as any warranty arising from course of performance, course of dealing, or usage in trade.