Get Started with the Intel® oneAPI Base Toolkit for Windows*

ID 766891
Date 3/31/2025
Public

Troubleshooting

Potential errors and how to avoid or fix them.

Issue How to fix
Errors that occur during installation or directly after installation. See the Troubleshooting page of the Intel® oneAPI Toolkits Installation Guide for Windows* OS.
Undefined error appears when building a sample.

If the sample was built by using cmake and then make, more details to diagnose the reason for your error are available by rebuilding with the VERBOSE option:

make VERBOSE=1

Developing with Offline Systems: I need to develop on a system that is not connected to the internet.

If you are using an offline system, download the samples from a system that is internet connected and transfer the sample files to your offline system.

After you have downloaded the samples, follow the instructions in the README.md file. The readme file is located in the folder of the sample you are interested in.

The samples can be downloaded from the code samples repository.

The full set of documentation can be downloaded from Downloadable Documentation.

Unable to install toolkits or access libraries. Verify that you meet the System Requirements listed on the Intel® oneAPI Base Toolkit product page

When building a sample on Windows, error MSB8020: compiler not found appears.

When compiling, this error appears:

error MSB8020: The build tools for Intel® oneAPI DPC++ Compiler (Platform Toolset = 'Intel® oneAPI DPC++ Compiler') cannot be found. To build using the Intel® oneAPI DPC++ Compiler build tools, please install Intel® oneAPI DPC++ Compiler build tools. Alternatively, you may upgrade to the current Visual Studio tools by selecting the Project menu or right-click the solution, and then select "Retarget solution."

This issue can occur if Visual Studio is installed after a oneAPI Toolkit, resulting in the toolkit plug-ins being absent.

To fix this problem, uninstall and reinstall your oneAPI toolkits:

  1. In Windows settings, open Add or Remove Programs.
  2. Click on Intel® oneAPI toolkits.
  3. Click Uninstall.
  4. After the Uninstall process is complete, verify that Visual Studio and/or MSBuild are installed.
  5. Install your oneAPI toolkits following the same procedure you used the first time. To download the software, go to the Intel® oneAPI Toolkits page.