intel/compute-runtime repository overview

⁠Intel® Graphics Compute Runtime for oneAPI Level Zero and OpenCL™ Driver Container

This container provides compute API support (Level Zero and OpenCL) for Intel graphics hardware architectures.

The following table lists the available Docker image tags and their meaning.

⁠Kernel requirements

To use Intel GPU hardware with this container, the host system must run a kernel that supports your specific GPU model. This section describes all approaches to obtaining a compatible kernel.

⁠Linux distribution kernel

Most Linux distributions backport hardware support to their stable kernel releases. This means that your distribution kernel may support your GPU even if its version number is lower than the upstream kernel version listed in the hardware support table⁠. Refer to your distribution's official documentation for more information about kernel management and hardware support.

Note that this container is officially supported only on Ubuntu. It may work on other Linux distributions with compatible kernels, but such configurations have not been officially validated. For non-Ubuntu distributions, refer to the official installation instructions⁠ for your platform and ensure the kernel version meets the documented requirements.

⁠Upstream Linux kernel

If your distribution kernel does not support your GPU, you can install a recent upstream Linux kernel. Newer hardware often requires features available only in recent kernel releases. Refer to the hardware support table⁠ for the minimum required upstream kernel version for your device.

⁠Intel-provided kernel

If neither distribution nor upstream kernels fully support your hardware, Intel provides Dynamic Kernel Module Support (DKMS) modules and a dedicated Ubuntu kernel through a Personal Package Archive (PPA).

⁠DKMS

For supported enterprise distributions, Intel provides hardware support through DKMS modules. To verify platform support and install DKMS modules, refer to the official installation guides⁠.

⁠Ubuntu PPA

For Ubuntu systems, Intel provides a dedicated kernel through a PPA that offers maximum hardware coverage for Intel GPUs.

To install the Intel kernel from the intel-graphics PPA, follow these steps:

1. Update the package index and install repository management tools.

   sudo apt-get update
   sudo apt-get install -y software-properties-common
   

   Copy

2. Add the Intel Graphics PPA.

   sudo add-apt-repository -y ppa:kobuk-team/intel-graphics
   

   Copy

3. Install the Intel GPU kernel package.

   sudo apt-get update
   sudo apt-get install -y linux-intel
   

   Copy

⁠Supported hardware

The container images support a wide range of Intel GPU architectures. For detailed information on supported hardware, refer to the hardware support table⁠.

⁠Known limitations

The following Intel GPUs are not fully validated with the provided container images and are not guaranteed to work:

• Intel® Data Center GPU Max Series
• Intel® Data Center GPU Flex Series

⁠Running the container

Run the image on a Linux host with Intel GPU hardware and a compatible kernel installed, as in the following example:

DEVICE=${DEVICE:-/dev/dri/renderD128}
DEVICE_GRP=$(stat --format %g "$DEVICE")
docker run -it --rm \
    --device "$DEVICE" \
    --group-add "$DEVICE_GRP" \
    -v /dev/dri/by-path:/dev/dri/by-path \
    --ipc=host \
    intel/compute-runtime:latest

⁠License agreement

By downloading and using these container images and the included software, you agree to the terms and conditions of the software license agreements⁠.

In accordance with the terms and conditions of these licenses, particularly those requiring source code availability, such as GPL, the source code for all open-source components included in these container images can be obtained from here⁠.

⁠Notes

All Ubuntu container images are intended for demo purposes only and not intended for production use. To receive expanded security maintenance from Canonical on the Ubuntu base layer, you may follow the how-to guide to enable Ubuntu Pro in a Dockerfile⁠ which will require the image to be rebuilt.

⁠Acknowledgements

© Intel Corporation. Intel, Intel® Graphics Compute Runtime for oneAPI Level Zero and OpenCL™ Driver and other Intel marks are trademarks of Intel Corporation or its subsidiaries.

* Other names and brands may be claimed as the property of others.