Installing Intel® Open Middleware Xe

Intel® Open Middleware Xe (Intel® OMIX) provides a validated Intel GPU software stack with pinned component versions and additional compute packages for AI workloads. It offers a streamlined way to install key Intel components for compute use cases, including:

• Intel Level Zero and OpenCL drivers

• Intel SYCL compiler

• Intel performance libraries for compute, such as oneDNN and oneMKL

These packages install the full compute software for Intel GPUs required to develop and run AI applications. For cases where only a subset of components is needed, the Intel OMIX repository also provides the following packages:

• intel-gpu and intel-gpu-dev (intel-gpu-devel on RHEL): Install all low-level runtime components, including Level Zero, OpenCL, and media drivers.

• intel-gpu-compute and intel-gpu-compute-dev (intel-gpu-compute-devel on RHEL): Install compute-specific low-level runtime components only, including Level Zero and OpenCL drivers.

If you intend to run Intel OMIX in a container, skip this installation procedure and use the prebuilt Intel OMIX container images instead. If you already have Intel OMIX installed and want to upgrade it, see the Upgrade section.

Prerequisites

Ubuntu

Before you begin, make sure all of the following prerequisites are met:

• Use one of the supported GPUs:

  • Intel® Arc™ Pro B50

  • Intel® Arc™ Pro B60

  • Intel® Arc™ Pro B65

  • Intel® Arc™ Pro B70

• Use one of the following supported operating systems:

  • Ubuntu Desktop 26.04

  • Ubuntu Desktop 24.04.4

  • Ubuntu Desktop 24.04 with the Hardware Enablement (HWE) kernel

  Note

  Use a clean system without preinstalled Intel GPU user-mode packages from the PPA. Each Intel OMIX release is validated as a specific combination of pinned component versions, so newer Intel packages from the PPA or other repositories can cause dependency conflicts or require package downgrades.

• Make sure no conflicting Intel repositories or newer Intel packages are already installed.

  grep -rsnH intel /etc/apt/sources.list*
  apt-cache policy | grep -i intel
  apt list --installed | grep -E "intel|igc|igsc|metee|xpu|level-zero"
  

  If the commands above find the intel-graphics PPA or packages installed from it, remove them by following the Uninstallation procedure in the PPA installation guide before proceeding.

• Update your system with the latest Intel GPG public key from https://repositories.intel.com/gpu/intel-graphics.key.

  wget -qO - https://repositories.intel.com/gpu/intel-graphics.key | \
    sudo gpg --yes --dearmor --output /usr/share/keyrings/intel-graphics.gpg
  

RHEL

Before you begin, make sure all of the following prerequisites are met:

• Use one of the supported GPUs:

  • Intel® Arc™ Pro B50

  • Intel® Arc™ Pro B60

  • Intel® Arc™ Pro B65

  • Intel® Arc™ Pro B70

• Use one of the following supported operating systems:

  • RHEL 9.8

  • RHEL 10.2

• Update your system with the latest Intel GPG public key from https://repositories.intel.com/gpu/intel-graphics.key.

  sudo rpm --import https://repositories.intel.com/gpu/intel-graphics.key
  

Installation

Ubuntu

1. Update package metadata and install the tools required to add repository access.

   sudo apt update
   sudo apt install -y gnupg wget
   

2. Add the package repository. Select the Online tab to configure the network repository, or the Offline installer tab for the standalone offline installer, which only enables the repository without modifying any other system configuration.

   Online

   . /etc/os-release
   if [[ ! " resolute noble " =~ " ${VERSION_CODENAME} " ]]; then
       echo "Ubuntu version ${VERSION_CODENAME} not supported"
   else
       echo "deb [arch=amd64 signed-by=/usr/share/keyrings/intel-graphics.gpg] https://repositories.intel.com/gpu/ubuntu ${VERSION_CODENAME}/intel-omix/0.4 unified" | \
       sudo tee /etc/apt/sources.list.d/intel-gpu-${VERSION_CODENAME}.list
       sudo apt update
   fi
   

   Offline installer

   Each offline installer is published alongside a SHA-384 checksum (.run.sha384) and a detached GPG signature (.run.asc) verifiable with the Intel Graphics public key. The following command verifies both files before running the installer, using the keyring written in the Prerequisites section.

   . /etc/os-release
   if [[ ! " resolute noble " =~ " ${VERSION_CODENAME} " ]]; then
       echo "Ubuntu version ${VERSION_CODENAME} not supported"
   else
       installer=intel-omix-ubuntu-${VERSION_CODENAME}-0.4.run
       base=https://repositories.intel.com/gpu/ubuntu/dists/${VERSION_CODENAME}/intel-omix/0.4
       wget ${base}/${installer} &&
           wget ${base}/${installer}.sha384 &&
           wget ${base}/${installer}.asc &&
           sha384sum -c ${installer}.sha384 &&
           gpg --no-default-keyring --keyring /usr/share/keyrings/intel-graphics.gpg --verify ${installer}.asc ${installer} &&
           chmod +x ${installer} &&
           sudo ./${installer}
   fi
   

   The offline installer includes its own documentation covering uninstallation and upgrade procedures. Run the offline installer with the -s parameter to access it.

   Note

   The commands above target the latest Intel OMIX release. To use a specific release, replace the version number in the repository URL with the desired version and, if needed, update the Ubuntu version based on the Support Matrix. You can specify a full major.minor.patch version, such as 0.4.0, for that exact release; a major.minor value, such as 0.4, for the latest hotfix in that series; or a major version, such as 0, for the latest in that major series. If no version is specified, the latest available release is installed.

3. Install the development or runtime package, depending on your use case.

   # Development
   sudo apt install -y intel-omix-dev
   
   # Runtime
   sudo apt install -y intel-omix
   

4. Reboot the system to activate the required kernel.

   sudo reboot
   

5. List the group assigned ownership of the render nodes and the groups you are a member of to check whether you belong to the group required to access GPU functionality. The render group allows access to GPU resources for rendering tasks without granting full access to display management or other more sensitive operations.

   stat -c "%G" /dev/dri/render*
   groups ${USER}
   

6. If you are not a member of the same group used by the DRM render nodes, add your user to the render node group.

   sudo gpasswd -a ${USER} render
   

7. Change the active group for the current shell.

   newgrp render
   

RHEL

1. Add the package repository. Select the Online tab to configure the network repository, or the Offline installer tab for the standalone offline installer, which only enables the repository without modifying any other system configuration.

   Online

   . /etc/os-release
   if [[ ! " 9.8 10.2 " =~ " ${VERSION_ID} " ]]; then
       echo "RHEL version ${VERSION_ID} not supported"
   else
       echo "Installing online network repository for ${VERSION_ID}"
       sudo dnf install -y 'dnf-command(config-manager)'
       sudo dnf config-manager --add-repo \
       https://repositories.intel.com/gpu/rhel/${VERSION_ID}/intel-omix/0.4/unified/intel-gpu-${VERSION_ID}.repo
   fi
   

   Offline installer

   Each offline installer is published alongside a SHA-384 checksum (.run.sha384) and a detached GPG signature (.run.asc) verifiable with the Intel Graphics public key. The following command verifies both files before running the installer. Because gpg --verify uses the user’s GPG keyring rather than the RPM keyring imported in the prerequisites section, the command also imports the key into GPG.

   . /etc/os-release
   if [[ ! " 9.8 10.2 " =~ " ${VERSION_ID} " ]]; then
       echo "RHEL version ${VERSION_ID} not supported"
   else
       installer=intel-omix-rhel-${VERSION_ID}-0.4.run
       base=https://repositories.intel.com/gpu/rhel/${VERSION_ID}/intel-omix/0.4
       wget ${base}/${installer} &&
           wget ${base}/${installer}.sha384 &&
           wget ${base}/${installer}.asc &&
           sha384sum -c ${installer}.sha384 &&
           wget -qO - https://repositories.intel.com/gpu/intel-graphics.key | gpg --import &&
           gpg --verify ${installer}.asc ${installer} &&
           chmod +x ${installer} &&
           sudo ./${installer}
   fi
   

   The offline installer includes its own documentation covering uninstallation and upgrade procedures. Run the offline installer with the -s parameter to access it.

   Note

   The commands above target the latest Intel OMIX release. To use a specific release, replace the version number in the repository URL with the desired version and, if needed, update the RHEL version based on the Support Matrix. You can specify a full major.minor.patch version, such as 0.4.0, for that exact release; a major.minor value, such as 0.4, for the latest hotfix in that series; or a major version, such as 0, for the latest in that major series. If no version is specified, the latest available release is installed.

2. Install the development or runtime package, depending on your use case.

   # Development
   sudo dnf install -y intel-omix-devel
   
   # Runtime
   sudo dnf install -y intel-omix
   

3. Reboot the system to activate the required kernel.

   sudo reboot
   

4. List the group assigned ownership of the render nodes and the groups you are a member of to check whether you belong to the group required to access GPU functionality. The render group allows access to GPU resources for rendering tasks without granting full access to display management or other more sensitive operations.

   stat -c "%G" /dev/dri/render*
   groups ${USER}
   

5. If you are not a member of the same group used by the DRM render nodes, add your user to the render node group.

   sudo gpasswd -a ${USER} render
   

6. Change the active group for the current shell.

   newgrp render
   

Upgrade

Ubuntu

Follow this procedure to upgrade an existing Intel OMIX installation to a newer version.

1. Add the online network package repository with a newer OMIX version. The following command targets the latest Intel OMIX release. To install a different version, replace the version number in the repository URL with the desired version and, if needed, update the Ubuntu version in the command based on the Support Matrix.

   . /etc/os-release
   if [[ ! " resolute noble " =~ " ${VERSION_CODENAME} " ]]; then
       echo "Ubuntu version ${VERSION_CODENAME} not supported"
   else
       echo "deb [arch=amd64 signed-by=/usr/share/keyrings/intel-graphics.gpg] https://repositories.intel.com/gpu/ubuntu ${VERSION_CODENAME}/intel-omix/0.4 unified" | \
       sudo tee /etc/apt/sources.list.d/intel-gpu-${VERSION_CODENAME}.list
       sudo apt update
   fi
   

   Note

   In the Intel OMIX repository path in the command above, you can specify a full major.minor.patch version, such as 0.4.0, to install that exact release. Specifying a major.minor value, such as 0.4, installs the latest available hotfix release in that series, while specifying only the major version, such as 0, installs the latest available release in that major series. If no version is specified, the latest available release is installed.

2. Upgrade the runtime package.

   sudo apt-get install --only-upgrade intel-omix
   

3. Upgrade the development package.

   sudo apt-get install --only-upgrade intel-omix-dev
   

RHEL

Follow this procedure to upgrade an existing Intel OMIX installation to a newer version.

1. Add the online network package repository. The following command targets the latest Intel OMIX release. To install an earlier release, replace the version number in the repository URL with the desired version and, if needed, update the Ubuntu version in the command based on the Support Matrix.

   . /etc/os-release
   if [[ ! " 9.8 10.2 " =~ " ${VERSION_ID} " ]]; then
       echo "RHEL version ${VERSION_ID} not supported"
   else
       echo "Installing online network repository for ${VERSION_ID}"
       sudo dnf install -y 'dnf-command(config-manager)'
       sudo dnf config-manager --add-repo \
       https://repositories.intel.com/gpu/rhel/${VERSION_ID}/intel-omix/0.4/unified/intel-gpu-${VERSION_ID}.repo
   fi
   

   Note

   In the Intel OMIX repository path in the command above, you can specify a full major.minor.patch version, such as 0.4.0, to install that exact release. Specifying a major.minor value, such as 0.4, installs the latest available hotfix release in that series, while specifying only the major version, such as 0, installs the latest available release in that major series. If no version is specified, the latest available release is installed.

2. Upgrade the runtime package.

   sudo dnf upgrade -y intel-omix
   

3. Upgrade the development package.

   sudo dnf upgrade -y intel-omix-devel
   

Verification

Follow this procedure to verify that Intel OMIX is installed and functional.

1. Verify the Intel® XPU Manager installation by running a device discovery scan. This confirms that the tool can detect the installed GPU.

   xpu-smi discovery
   

2. Verify the compute stack by listing the available OpenCL platforms and devices.

   clinfo -l
   

3. Verify the Intel® oneAPI DPC++/C++ Compiler (SYCL) stack. Source the environment script to configure the required environment variables, then list the available SYCL devices.

   source /opt/intel/oneapi/setvars.sh
   sycl-ls
   

If each command detects your GPU without errors, Intel OMIX is installed and ready to use.

Uninstallation

Follow this procedure to remove Intel OMIX from your system.

Ubuntu

1. Remove the package you installed, development or runtime.

   # Development
   sudo apt remove -y intel-omix-dev
   
   # Runtime
   sudo apt remove -y intel-omix
   

2. Remove packages that were installed as dependencies and are no longer required.

   sudo apt autoremove -y
   

RHEL

1. Remove the package you installed, development or runtime.

   # Development
   sudo dnf remove -y intel-omix-devel
   
   # Runtime
   sudo dnf remove -y intel-omix
   

2. Remove packages that were installed as dependencies and are no longer required.

   sudo dnf autoremove -y
   

References

If you need more information about any of the key Intel OMIX components, use the following list of their repositories and documentation. Refer to the Intel OMIX release notes for the exact version of each component included in a specific Intel OMIX release.

• Intel® Graphics Compiler for OpenCL™

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

• Intel® oneAPI Collective Communications Library (oneCCL): Developer Guide and Reference

• Intel® oneAPI Deep Neural Networks Library (oneDNN)

• Intel® oneAPI DPC++/C++ Compiler: Developer Guide and Reference

• Intel® oneAPI DPC++ Library (oneDPL): Developer Guide and Reference

• Intel® oneAPI Level Zero: Specification

• Intel® oneAPI Math Kernel Library (oneMKL): Developer Guide

• Intel® Profiling Tools Interfaces for GPU: API Reference

• Intel® XPU Manager and XPU System Management Interface