Intel® oneAPI Toolkits Installation Guide for macOS

Last Updated:09/14/2020

1. Introduction

This guide covers the installation of Intel® oneAPI Toolkits on macOS* systems.

Please read the Toolkit Release notes and System requirements to learn more about compatibility details.

2. Online Installer

  1. Go to the Intel® oneAPI page.
  2. Locate the Intel® oneAPI Base Toolkit or Domain-Specific Toolkit for Specialized Workloads.

Some domain-specific toolkits require you to install the Intel oneAPI Base Toolkit first for full functionality.

  1. Click the Get the Base Kit button or click the Domain-Specific Toolkit button for standalone capable kits.
  2. Select your OS from the drop-down list.
  3. For a web-based download, click the Configure Install button
  4. Click on the Download button for the Online Installer. Alternatively, you can choose the Local Installer.

Online Installer

2.1 Run the Online Installer

Click the Download button to download the oneAPI toolkit installer.

  1. Double-click to mount ./w_[Toolkit Name]Kit_[version].dmg disk image
  2. Launch ./installer.sh
  3. Follow installer instructions

Once the installation is complete, verify that your toolkit has been installed to the correct installation directory /opt/intel/oneapi

3. Local Installer (Full package)

This section contains steps to install your toolkit using the Local Installer. When selecting Local Installer the full package is available for download.

On selected toolkit download page click Get It Now button. Select your OS and then under Local Installer on the right, click the Download button. Save the installation file to your computer.

Local Installer

You can choose to install:

3.1 Install with the GUI

Follow the instructions below:

  1. Double-click to mount ./w_[Toolkit Name]Kit_[version].dmg disk image
  2. Launch ./installer.sh
  3. Follow installer instructions

Once the installation is complete, verify that your toolkit has been installed to the default directory /opt/intel/oneapi

3.2 Install with the Command Line

3.2.1 Silent Install

Follow the instructions below:

  1. Mount ./w_[Toolkit Name]Kit_[version].dmg disk image
  2. Go to the directory where the installer is located and run the following command:
sudo ./install.sh --silent --eula accept

For example:

hdiutil attach m_BaseKit_b_2021.1.8.1970_offline.dmg
cd /Volumes/m_BaseKit_b_2021.1.8.1970_offline/bootstrapper.app/Contents/MacOS/
./install.sh --silent --eula accept

The installation may take some time to finish. Once the installation is complete, verify that the toolkit is installed in the default directory: /opt/intel/oneapi

3.2.2 Custom Install oneAPI Toolkit

The following explains how to install selected oneAPI Toolkit components from the Command Line on macOS*. You can specify which products or components to include when installing your toolkit from the command line. Follow the steps below:

  1. Display the list of already installed products and products included in the downloaded package using the following command:
l_[Toolkit Name]Kit_[version].sh -s -a --list-products

Example of output:
ID Version Language Installed Name
==========================================================================================================
intel.oneapi.win.tbb.product 2021.1-496.beta08 false Intel(R) oneAPI Threading Building Blocks

2. Display the list of components in product of current package using the following command:

l_[Toolkit Name]Kit_[version].sh -s -a --list-components 

3. Display the list of components of any installed product on the system using the following command:

l_[Toolkit Name]Kit_[version].sh -s -a --list-components --product-id intel.oneapi.win.tbb.product --product-ver 2021.1-496.beta08

Example of output:
ID Version Language Name
==============================================================================================
intel.oneapi.win.tbb.devel 2021.1-496.beta08 Intel(R) oneAPI Threading Building Blocks

4. Run the installation with the command:

sudo ./install.sh --silent --eula accept
  • Once the installation is complete, verify that the toolkit is installed in default directory /opt/intel/oneapi

4. Use Code Samples

We have code samples available for download on GitHub* to help you get started. You can clone them to your local machine directly from the following repositories:

For instructions on how to build and run Samples see Get Started With the Intel oneAPI Toolkits for macOS.

5. Uninstall oneAPI Toolkits and components

5.1 Uninstall Using GUI

  • Use the following commands to uninstall oneAPI Toolkits:
cd /opt/intel/oneapi/installer 
sudo ./install.sh
  • Select "Remove" to remove the toolkit
  • Use Installer dashboard dialog with the list of already installed products (toolkits) to Modify, Repair or Remove each toolkit separately.

5.2 Use Silent CLI

  • Use the following commands to uninstall oneAPI Toolkits:
cd /opt/intel/oneapi/installer
sudo ./install.sh --action remove --product-id intel.oneapi.win.tbb.product --product-ver 2021.1-496.beta08

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.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804