1. Make sure your system meets the System Requirements.

2. Microsoft Visual Studio* is required for installations on Windows*. The installer checks for Visual Studio. If you do not have Visual Studio, you can install one of the following versions:

• Visual Studio 2019 
• Visual Studio 2022 
• Visual Studio build tools 2019 
• Visual Studio build tools 2022 

For more information, see Visual Studio 2019 or Visual Studio 2022 
3. Before enabling integration into Microsoft Visual Studio via the oneAPI toolkit installer, install the Desktop development with C++ workload into each Visual Studio instance.

Make sure your system meets the System Requirements.

1. Make sure your system meets the System Requirements.

2. To add APT repository access, enter the command for the installation prerequisites:

sudo apt update
sudo apt install -y gpg-agent wget

3. To set up the repository, download the key to the system keyring:

# download the key to system keyring
wget -O- https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB \
| gpg --dearmor | sudo tee /usr/share/keyrings/oneapi-archive-keyring.gpg > /dev/null

# add signed entry to apt sources and configure the APT client to use Intel repository:
echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/oneapi all main" | sudo tee /etc/apt/sources.list.d/oneAPI.list

4. Update the packages list and repository index:

sudo apt update

1. Make sure your system meets the System Requirements.

2. To set up the repository, create the YUM or DNF repo file in the /temp directory as a normal user:

tee > /tmp/oneAPI.repo << EOF
[oneAPI]
name=Intel® oneAPI repository
baseurl=https://yum.repos.intel.com/oneapi
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://yum.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB
EOF

1. Move the newly created oneAPI.repo file to the YUM/DNF configuration directory /etc/yum.repos.d:

sudo mv /tmp/oneAPI.repo /etc/yum.repos.d

Ubuntu 24.04

docker pull intel/oneapi-basekit:latest

docker pull intel/oneapi-basekit:2025.1.2-0-devel-ubuntu24.04

Ubuntu 22.04

docker pull intel/oneapi-basekit:2025.1.2-0-devel-ubuntu22.04

Rocky Linux 9

docker pull intel/oneapi-basekit:2025.1.2-0-devel-rockylinux9

 Ubuntu 24.04

docker pull intel/cpp-essentials:latest

docker pull intel/cpp-essentials:2025.1.1-0-devel-ubuntu24.04

Ubuntu 22.04

docker pull intel/cpp-essentials:2025.1.1-0-devel-ubuntu22.04

Rocky Linux 9

docker pull intel/cpp-essentials:2025.1.1-0-devel-rockylinux9

 Ubuntu 24.04

docker pull intel/deep-learning-essentials:latest

docker pull intel/deep-learning-essentials:2025.1.2-0-devel-ubuntu24.04

Ubuntu 22.04

docker pull intel/deep-learning-essentials:2025.1.2-0-devel-ubuntu22.04

Rocky Linux 9

docker pull intel/deep-learning-essentials:2025.1.2-0-devel-rockylinux9

1. From the console, locate the downloaded install file.

• To launch the GUI installer as the root, enter sudo sh ./<package name>. For example: sh ./intel-oneapi-base-toolkit-2025.1.2.9_offline.sh
• Optionally, to launch the GUI installer as the current user, enter $ sh ./<package name>. For example: $ sh ./intel-oneapi-base-toolkit-2025.1.2.9_offline.sh

       2. Follow the instructions in the installer.

1. From the console, locate the downloaded install file.
2. Use sudo sh ./<file name> to launch the GUI installer as the root. 
   Optionally, use $ sh ./<file name> to launch the GUI installer as the current user.  
3. Follow the instructions in the installer.

1. From the console, locate the downloaded install file.
2. To launch the GUI installer as the root, do one of the following:

• Enter sudo sh ./<file name>.  
• Optionally, to launch the GUI installer as the current user, enter $ sh ./<file name>.

      3. Follow the instructions in the installer. 

1. Read the documentation for Command Line Installation Parameters.

2. Decide which parameters you want to use. For example, sudo sh ./intel-oneapi-base-toolkit-2025.1.2.9_offline.sh -a --silent --cli --eula accept indicates that you are doing a silent install (--silent) using a command-line interface (--cli) and accept the End User License Agreement (--eula accept)

Note You must accept the End User License Agreement. Make sure you add the parameter --eula accept to the command.

       3. Download the installer by entering the following command: 

wget https://registrationcenter-download.intel.com/akdlm/IRC_NAS/ac050ae7-da93-4108-823d-4334de3f4ee8/intel-oneapi-base-toolkit-2025.1.2.9_offline.sh

​​​​​​       4. Run the install script by entering the following command parameters (minimum). You can add more parameters as needed.

sudo sh ./intel-oneapi-base-toolkit-2025.1.2.9_offline.sh -a --silent --cli --eula accept

1. To launch the GUI installer, Select the .exe file.
2. Follow the instructions in the installer.

1. Review the command-line options in Command Line Installation Parameters.

2  Download the toolkit by entering the following command:

wget https://registrationcenter-download.intel.com/akdlm/IRC_NAS/2cbb02eb-dd4c-4058-a4ac-2e38729a8409/intel-oneapi-base-toolkit-2025.1.2.7_offline.exe

3. Update the following with your selected parameters:

• For a silent installation, run the following command:

intel-oneapi-base-toolkit-2025.1.2.7_offline.exe -a --silent --eula accept

In a silent installation, integration into Microsoft Visual Studio is by default (if supported). You must install the Desktop development with C++ workload in each Visual Studio instance you start.

• To skip Visual Studio* integration, pass the following arguments to the installation command by entering: -p=NEED_VSXXXX_INTEGRATION=0, where XXXX is the Visual Studio version. For example, to install a toolkit and skip integration into Visual Studio 2019, enter the following installation command:

intel-oneapi-base-toolkit-2025.1.2.7_offline.exe -s -a --silent --eula accept -p=NEED_VS2019_INTEGRATION=0

4. After the installation is complete, verify that the toolkit is installed in the default directory: C:\Program Files(x86)\Intel\oneAPI.

1. Review the command line options Command Line Installation Parameters.
2. Download the toolkit.

wget https://registrationcenter-download.intel.com/akdlm/IRC_NAS/da3f1dbe-47ad-49b5-acb9-3a7858b93d0d/intel-cpp-essentials-2025.1.1.10_offline.exe

3. Update the following with your selected parameters.

4. For silent install, run the following command:

intel-cpp-essentials-2025.1.1.10_offline.exe -a --silent --eula accept

In silent mode, integration into Visual Studio* is installed by default (if supported). You need to have the Desktop development with C++ workload installed into each Visual Studio instance beforehand. To skip Visual Studio* integration, pass the following arguments to the installation command: -p=NEED_VSXXXX_INTEGRATION=0, where XXXX is the Visual Studio version. For example, to install a toolkit and skip integration into Visual Studio* 2019, use the following installation command:

intel-cpp-essentials-2025.1.1.10_offline.exe -s -a --silent --eula accept -p=NEED_VS2019_INTEGRATION=0

5. Once the installation is complete, verify that the toolkit is installed in the default directory: C:\Program Files(x86)\Intel\oneAPI.

1. Review the command-line options in Command Line Installation Parameters.

2. Download the toolkit by entering the following command:

wget https://registrationcenter-download.intel.com/akdlm/IRC_NAS/49ad4e54-da93-47e1-9909-f3e6aa9ef0cd/intel-deep-learning-essentials-2025.1.2.11_offline.exe

3. Update the following with your selected parameters:

• For a silent installation, run the following command:

sudo sh ./intel-deep-learning-essentials-2025.1.2.11_offline.exe -a --silent --eula accept

In a silent installation, integration into Microsoft Visual Studio is by default (if supported). You must install the Desktop development with C++ workload in each Visual Studio instance you start.

• To skip Visual Studio* integration, pass the following arguments to the installation command by entering: -p=NEED_VSXXXX_INTEGRATION=0, where XXXX is the Visual Studio version. For example, to install a toolkit and skip integration into Visual Studio 2019, enter the following installation command:

intel-deep-learning-essentials-2025.1.2.11_offline.exe -s -a --silent --eula accept -p=NEED_VS2019_INTEGRATION=0

4. After the installation is complete, verify that the toolkit is installed in the default directory: C:\Program Files(x86)\Intel\oneAPI.

From the console, locate the downloaded installation file.

• To launch the GUI installer as the root, use sudo sh ./<package name>. For example: sudo sh ./intel-cpp-essentials-2025.1.1.8_offline.sh

• Optionally, to launch the GUI installer as the current user, use $ sh ./<package name>. For example: $ sh ./intel-cpp-essentials-2025.1.1.8_offline.sh

1. Review the Command Line Installation Parameters.

2. Decide which parameters you want to use. For example, sudo sh ./intel-cpp-essentials-2025.1.1.8_offline.sh -a --s --cli --eula indicates that you are doing a silent install (--s) using a command line interface (--cli) and accepting the End User License Agreement (--eula accept).

Note You must accept the End User License Agreement. Make sure you add the parameter --eula accept to the command.

3. Download and run the installer with the command parameters you need for your configuration. See the following example:

wget https://registrationcenter-download.intel.com/akdlm/IRC_NAS/ee18bd01-7360-4bde-abc0-05f780620549/intel-cpp-essentials-2025.1.1.8_offline.sh

4. Do one of the following to update your selected parameters.

• For a silent installation, run the following command:

sudo sh ./intel-cpp-essentials-2025.1.1.8_offline.sh -a --silent --eula accept

5. Once the installation is complete, verify that the toolkit is installed in the default directory: C:\Program Files(x86)\Intel\oneAPI.

From the console, locate the downloaded installation file. Use sudo sh ./<package name> to launch the GUI installer as the root. For example: sh ./intel-cpp-essentials-2025.1.1.8.sh 

Optionally, use $ sh ./<package name> to launch the GUI installer as the current user. For example: $ sh ./intel-cpp-essentials-2025.1.1.8.sh

Follow the instructions in the installer.

From the console, locate the downloaded installation file.

• Use sudo sh ./<file name> to launch the GUI installer as the root. For example: sudo sh ./intel-deep-learning-essentials-2025.1.2.13_offline.sh
• Optionally, use $ sh ./<file name> to launch the GUI installer as the current user. For example: $ sh ./intel-deep-learning-essentials-2025.1.2.13_offline.sh

1. Review the Command Line Installation Parameters.

2. Decide which parameters you want to use. For example, sudo sh ./intel-deep-learning-essentials-2025.1.2.13_offline.sh -a --s --cli --eula accept indicates that you are doing a silent install (--s) using a command line interface (--cli) and accepting the End User License Agreement (--eula accept).

Note You must accept the End User License Agreement. Make sure you add the parameter --eula accept to the command.

3. Download and run the installer with the command parameters you need for your configuration. See the following example:

wget https://registrationcenter-download.intel.com/akdlm/IRC_NAS/73863085-58a9-4dbb-ae65-83497edb05fa/intel-deep-learning-essentials-2025.1.2.13_offline.sh

4. Do one of the following to update your selected parameters.

• For a silent instalation, run the following command:

sudo sh ./intel-deep-learning-essentials-2025.1.2.13_offline.sh -a --silent --eula accept

​​​​ 5. Once the installation is complete, verify that the toolkit is installed in the default directory: /opt/intel/oneapi

1. To install CMake, pkg-config, and the GNU development tools, open an Ubuntu terminal, and then enter the following command:

sudo apt update
sudo apt -y install cmake pkg-config build-essential

2. To verify the installation location, enter this command:

which cmake pkg-config make gcc g++

 To install CMake, pkg-config, and the GNU development tools on your Linux system:

1. Open a terminal session and enter the following commands:

Ubuntu*

sudo apt update
sudo apt -y install cmake pkg-config build-essential

Red Hat* and Fedora*

sudo yum update
sudo yum -y install cmake pkgconfig
sudo yum groupinstall "Development Tools"

SUSE*

sudo zypper update
sudo zypper --non-interactive install cmake pkg-config
sudo zypper --non-interactive install pattern devel_C_C++

  2. To verify the installation location, enter this command:

which cmake pkg-config make gcc g++

1. Open a terminal.
2. To install CMake, pkg-config, and the GNU development tools, enter the following command:

sudo zypper update
sudo zypper --non-interactive install cmake pkg-config
sudo zypper --non-interactive install pattern devel_C_C++

3. To verify the installation, enter the following command to display the installation location:

which cmake pkg-config make gcc g++

1. Open a terminal.
2. Install CMake, pkg-config, and the GNU development tools by entering the following command:

sudo yum update
sudo yum -y install cmake pkgconfig
sudo yum groupinstall "Development Tools"

3. To verify the installation, enter the following command to display the installation location:

which cmake pkg-config make gcc g++

To use an Intel GPU, install the latest Intel GPU drivers.

To allow long-running GPU kernels in native environments, disable the GPU hangcheck by entering the following command to the Linux kernel boot parameters in GRUB_CMDLINE_LINUX_DEFAULT: i915.enable_hangcheck=0

To give a nonroot user access to the GPU device, use the following commands:

1. Determine which group name is assigned ownership of the render nodes by entering the command:  stat -c "%G" /dev/dri/render* groups
2. Determine if the current user is a member of that render node group by entering the command: groups ${USER}
3. Add the user to the group by entering: sudo gpasswd –a ${USER} video
4. Activate the video group by entering: newgrp video

Install Graphics Drivers

1. Download the Intel® Driver & Support Assistant (Intel® DSA) by following the link and clicking Download now. The Intel DSA tool will help you identify and install the correct driver for your system.
2. Run the Intel® DSA, and then follow the on-screen prompts to install the latest version of Intel Graphics - Windows 10 or 11 DCH Drivers.
3. To troubleshoot any installation issues or to manually install a driver without the use of the Intel DSA, see How to Install an Intel® Graphics Driver in Windows® 10 & Windows 11*.

Microsoft Visual Studio Instructions

There are two methods for verifying that the tools are installed correctly. Choose the one that works for you. Vector-Add is a simple sample used in both methods.

Microsoft Visual Studio

1. Follow the instructions in the Get Started Guide

Command Line Browser (recommended)

Use the oneAPI sample browser:

1. Create a folder where you want to store your sample. For example, C:\samples\vector-add
2. Open a command window. 
3. Set system variables by running setvars. There are two variants for component directory and unified directory layouts.

a. Component Directory Layout: "C:\Program Files (x86)\Intel\oneAPI\setvars.bat"

          Note: For Windows* PowerShell* users, enter this command:

cmd.exe "/K" '"C:\Program Files (x86)\Intel\oneAPI\setvars.bat" && powershell'

b. Unified Directory Layout: "C:\Program Files (x86)\Intel\oneAPI\<toolkit-version>\oneapi-vars.bat"

         Note: For Windows PowerShell* users, enter this command:

cmd.exe "/K" '"C:\Program Files (x86)\Intel\oneAPI\<toolkit-version>\oneapi-vars.bat" && powershell'

         The previous command assumes that you installed to the default folder. If you customized the installation folder, setvars | oneapi-vars is in your custom folder.

4. To launch the oneAPI Samples Browser utility, enter the following command: oneapi-cli

5. Press the up and down arrow keys to navigate to the sample: Create a project > cpp > Base: Vector Add.

6. To select the sample, press Enter. 

7. Specify the project's location. The default location includes the path from where the utility was run and the project name. 

8. Press Tab to select Create, and then press Enter. 

9. Configure the build system and build the Vector Add sample as described in the sample documentation.

Explore more samples in the oneAPI Samples Catalog.

There are three methods to verify that the tools are installed correctly. Pick the one that works for you. Vector add is a simple sample used in all three methods.

• Command-line browser (recommended)
• Microsoft Visual Studio Code
• Eclipse IDE

Command-Line Browser

To use the oneAPI sample browser utility:

1. Set environmental variables by sourcing the oneapi-vars.sh script:

. /opt/intel/oneapi/<toolkit-version>/oneapi-vars.sh

2. To launch the oneAPI Samples Browser utility, enter the following command :

oneapi-cli

3. Press  the up and down arrow keys to navigate to the sample: Create a project > cpp > Base: Vector Add.

4. To select the sample, press Enter.
5. Specify the project's location. The default location includes the path from where the utility was run and the name of the project. 
6. Press Tab to select Create, and then press Enter. 
7. Configure the build system and build the Vector Add sample as described in the sample documentation. 

Explore more samples in the oneAPI Samples Catalog.

Visual Studio Code

To run a sample, see Instructions for Using VS code ​​​​​​.

Eclipse IDE

To run a sample, see Eclipse Get Started Guide. 

Intel oneAPI Programming Guide

Single Components and Previous Versions

• Choose a tool from the the Stand-alone Component page.
• For the most current functional and security features, update to the latest version as it becomes available. Previous versions of the toolkit are available through Priority Support.