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

Download PDF
ID 766893
Date 3/31/2025
Public

Visible to Intel only — GUID: GUID-78AF7E4F-FE78-48A2-9EC4-6350D3DB386E

View Details

Document Table of Contents
Document Table of Contents x
Get Started with the Intel® oneAPI Base Toolkit for Linux*
Get Started with the Intel® oneAPI Base Toolkit for Linux* x
Configure Your CPU or GPU System Configure Your FPGA System Build and Run a Sample Project Using the Command Line Build and Run a Sample Project Using Eclipse* Build and Run a Sample Project Using Visual Studio Code Using Containers Using Cloud CI Systems Troubleshooting Next Steps Notices and Disclaimers
Build and Run a Sample Project Using the Command Line x
Next Steps
Next Steps x
SSH: Password-less Access to Remote Linux* Target SSH: Running Applications Built with Eclipse*
Build and Run a Sample Project Using Eclipse* x
Next Steps
Next Steps x
SSH: Password-less Access to Remote Linux* Target SSH: Running Applications Built with Eclipse*
Build and Run a Sample Project Using Visual Studio Code x
Next Steps
Next Steps x
SSH: Password-less Access to Remote Linux* Target SSH: Running Applications Built with Eclipse*
Using Containers x
Using Containers with the Command Line Using Intel® Advisor, Intel® Inspector or Intel® VTune™ Profiler with Containers Using Containers with Eclipse*
Next Steps x
SSH: Password-less Access to Remote Linux* Target SSH: Running Applications Built with Eclipse*
Get Started with the Intel® oneAPI Base Toolkit for Linux*

Using Containers with the Command Line

Compile and run the containers directly.

The below enables the GPU, if available, using --device=/dev/dri (may not be available in Linux* VM or Windows*). The command will leave you at a command prompt, inside the container, in interactive mode. 

image=intel/oneapi-basekit
# --device=/dev/dri enables the gpu (if available). May not be available in Linux VM or Windows
docker run --device=/dev/dri -it "$image"

If the docker is installed inside WSL, use the following command instead:

Once in the container, you can interact with it using Run a Sample Project Using the Command Line.

NOTE:
You may need to include proxy settings before -it "$image"if you are behind a proxy: 
docker run -e http_proxy="$http_proxy" -e https_proxy="$https_proxy" -it "$image"

Using Intel® Advisor, Intel® Inspector or Intel® VTune™ Profiler with Containers

When using these tools, extra capabilities have to be provided to the container with these options:

--cap-add=SYS_ADMIN --cap-add=SYS_PTRACE

docker run --cap-add=SYS_ADMIN --cap-add=SYS_PTRACE \
--device=/dev/dri -it "$image"

Parent topic: Using Containers
Level Two Title