Get Started

  • 2023.0
  • 12/16/2022
  • Public Content

Using Containers with Eclipse*

Install Eclipse

  1. Prerequisite: ensure Java* JRE 8 or 11 is installed.
  2. Download and install the latest Eclipse IDE for C/C++ Developers.
  3. Download and install the Intel® oneAPI Base Toolkit in order to easily browse samples.

Use the Samples Browser to Create an Eclipse Project

If you have installed the Intel® oneAPI Base Toolkit, you can use the Samples Browser integrated into the Eclipse IDE to create a project based on Intel® samples.
Run Eclipse and select
Browse Intel oneAPI Samples…
If you do not see an Intel menu in Eclipse, install the oneAPI Eclipse plugins, then return to this page for instructions on how to Build and Run a sample.
The Sample Browser dialog window will be displayed.
Expand the sample tree and select a sample. Click
to create a project based on the sample.

Configure Project Properties

  1. Make sure you've followed the steps described on the Using Containers page to download the Docker image.
  2. Open the Project Properties by right clicking
  3. In
    C/C++ Build
    , and open the
    Container Settings
    tab to set the following:
    1. Check
      Build Inside Docker Image
    2. Select the docker image to use. If there are no images listed, verify that Docker is enabled for non-root users. Alternatively, you can run Eclipse with sudo.
    3. Apply and close the settings.

Compile the Application

  1. Click the Build Icon .
  2. Confirm that the console prints "Running in image..."

Run Application

  1. Create a Run Configuration with
    Run Configurations
  2. Create a new C/C++ Container Launcher.
  3. Select the Container tab and make sure the
    is set to the correct Docker image. To enable GPU in the container, add
    in the
    Required Host Directories
    and check
    Run in Privileged Mode
  4. To enable GPU in the container, select the
    tab and add
    as Required Host Directories, and check
    Run in Privileged Mode
  5. Click the
  6. Confirm that the console prints
    Running in image...

Product and Performance Information


Performance varies by use, configuration and other factors. Learn more at