• 2021.6
  • 04/11/2022
  • Public Content

Install oneTBB on Windows* OS

This section describes how you can deploy the Intel® oneAPI Threading Building Blocks (oneTBB) library on a Windows* OS machine.
  • If you plan to install oneTBB as a part of Intel® oneAPI Base Toolkit, refer to the corresponding section of the Intel(R) oneAPI Toolkits Installation Guide.
  • If you plan to install oneTBB as a standalone product, follow the instructions below, using the installer GUI or a package manager of your choice.
Learn how to install oneTBB with GUI and package manager: * Install with GUI * Install with a Package Manager

Install with GUI

Step 1. Select the preferred installer
  1. Go to Download page. A list of available installers is displayed.
  2. Decide on the Windows installer type that you will use:
    • Online installer
      has a smaller file size but requires a permanent Internet connection while running.
    • Offline installer
      has a bigger file size but requires an Internet connection only to download the installer file, and then runs offline.
  3. Having decided on the installer type, click the corresponding link to start the download.
  4. Wait for the download to complete.
Step 2. Prepare the installer
For offline installer:
  1. Run the
    file you have downloaded. The installation package extractor will be launched.
  2. Specify the path where to extract the package - default is
  3. If necessary, select the
    Remove temporary extracted files after installation
  4. Click
For the online installer, the download starts automatically after you run the
Step 3. Run the setup
  1. If you are running the offline installer, click
    to proceed. The online installer will proceed automatically.
  2. In the
    step, select the
    I accept the terms of the license agreement
  3. Select the installation mode:
    • To use default installation settings, select
      Recommended Installation
      . oneTBB will be installed in the default location:
      %Program FIles (x86)%\Intel\oneAPI\
      . Click
      and proceed to the
      Integrate IDE
    • To modify installation settings, select
      Custom Installation
      and click
      . You will proceed to the
      Select Components
      step. However, no components other than oneTBB can be selected due to solution nature. In this mode, you can change the default installation location by clicking
      in the bottom-left corner of the window.
  1. At the
    Integrate IDE
    step, the program checks if it is possible to deploy oneTBB fully integrated with Microsoft Visual Studio IDE - for that, the supported IDE version must be installed on the target machine. If not installed, you can exit the setup and restart it after installing the IDE, or proceed without integration.
  2. At the
    Software Improvement Program
    step, select the option you prefer. Then click
    to start the installation.
  3. Wait for the process to complete. Then click
    to close the installer or
    Go to Installed Products
    to check for updates or take other actions.
Remember to configure environment variables after installation. See the Before You Begin section to learn about it.

Install with a Package Manager

To install oneTBB with a package manager, run the corresponding command described in the documentation:
Remember to configure environment variables after installation. See Before You Begin section to learn about it.

Upgrading oneTBB

The seamless upgrade is supported for oneTBB 2021.1 and later versions. To upgrade oneTBB to the latest version, run the setup, as described above.
If you used to work with older versions (TBB), consider that the new versions of oneTBB do not provide backward compatibility. See TBB Revamp: Background, Changes, and Modernization for details. Also, refer to Migrating from TBB for more information on migrating to oneTBB.

Uninstalling oneTBB

To uninstall oneTBB, use
Applications and Features
Programs and Features

Product and Performance Information


Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.