Installing Intel® Open Middleware Xe

Intel® Open Middleware Xe (Intel® OMIX) provides a validated Intel GPU software stack with pinned component versions. 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 or XPU-enabled AI frameworks 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

Before installing Intel OMIX, make sure your system meets the following hardware and operating system requirements:

• Supported hardware:

  • Intel® Arc™ Pro B50

  • Intel® Arc™ Pro B60

  • Intel® Arc™ Pro B65

  • Intel® Arc™ Pro B70

• Supported operating systems:

  • RHEL 9.8

  • RHEL 10.2

  • Ubuntu Desktop 26.04.1

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

Installation

Use this procedure to install Intel OMIX on a system immediately after installing the operating system, when no other Intel software is installed. If you have previously configured the system to use Intel repositories, package version conflicts may occur. Review the Troubleshooting section for guidance on resolving these conflicts before continuing.

Ubuntu

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

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

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
   

RHEL

1. 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
   

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 [[ ! " 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.

3. 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
   

This completes the steps for initial install. Proceed to the Verification section for steps to verify that install is working as expected.

Note that use of oneAPI libraries and compilers requires setting environment variables, for example source /opt/intel/oneapi/setvars.sh.

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. The examples in this procedure show Ubuntu 26.04.1 with two Intel® Arc™ Pro B70 GPUs, so your output may differ.

1. Run the Intel® XPU System Management Interface command-line utility to confirm that it lists the installed GPUs.

   $ xpu-smi
   

   Example output

   +----------------------------------------------+----------------------------+------------------------+
   |            Intel XPU-SMI v2.0    Driver: 9913356BC2F8B14798CAB3D    Level Zero: 1.32.0             |
   +----------------------------------------------+----------------------------+------------------------+
   | GPU  Name                    Persistence-M   | Bus-Id            Disp.A   |   Volatile Uncorr. ECC |
   | Fan              Temp  Pwr:Usage/Cap         | Memory-Usage               |   GPU-Util  Compute M. |
   +----------------------------------------------+----------------------------+------------------------+
   |   0  Intel(R) Arc(TM) Pro B  Off             | 0000:18:00.0      Off      |               Disabled |
   |      70 Graphics                             |                            |                        |
   | N/A               N/A  50W / 230W            | 28228MiB / 32656MiB        |      N/A       Default |
   +----------------------------------------------+----------------------------+------------------------+
   |   1  Intel(R) Arc(TM) Pro B  Off             | 0000:54:00.0      Off      |               Disabled |
   |      70 Graphics                             |                            |                        |
   | N/A               N/A  50W / 230W            | 28030MiB / 32656MiB        |      N/A       Default |
   +----------------------------------------------+----------------------------+------------------------+
   
   +-------+-------+--------+----------------+----------------------------------------------------------+
   | Processes:                                                                                         |
   |   GPU     PID    Type    Process Name                                             GPU Memory Usage |
   +-------+-------+--------+----------------+----------------------------------------------------------+
   |                                  No running GPU processes found.                                   |
   +-------+-------+--------+----------------+----------------------------------------------------------+
   

2. Check operating system, kernel, GPU driver load state, and group membership.

   echo '== OS =='; grep -E '^(NAME|VERSION)=' /etc/os-release
   echo; echo '== Kernel =='; uname -r
   echo; echo '== Xe driver loaded? =='; lsmod | grep -E '^(xe|i915)\b' || echo 'no xe/i915 module loaded'
   echo; echo '== DRM nodes =='; ls /dev/dri/
   echo; echo '== Does group membership allow GPU access? =='; id -nG | tr ' ' '\n' | grep -x render && echo 'OK' || echo 'MISSING — you cannot submit work to the GPU'
   

   Example output

   == OS ==
   NAME="Ubuntu"
   VERSION="26.04.1 LTS (Resolute Raccoon)"
   
   == Kernel ==
   7.0.0-31-generic
   
   == Xe driver loaded? ==
   xe                   4415488  555
   
   == DRM nodes ==
   by-path
   card0
   card1
   card2
   renderD128
   renderD129
   
   == Does group membership allow GPU access? ==
   render
   OK
   

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 the system checks complete without errors, Intel OMIX is installed and ready to use.

Uninstallation

Follow this procedure to remove Intel OMIX packages 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
   

Troubleshooting

Use this issue-specific guidance to investigate installation problems.

Repository version conflicts

If the package manager reports version conflicts, check for other Intel repositories and installed packages. Intel OMIX releases pin component versions, so packages from other repositories may cause dependency conflicts or require downgrades.

Inspect the configured Intel repositories and installed packages for your operating system.

Ubuntu

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 results identify the intel-graphics PPA or packages installed from it, follow the Uninstallation procedure in the PPA installation guide before proceeding. Additionally, remove references to the kobuk-team/intel-graphics PPA and apt.repos.intel.com from the APT sources to avoid version conflicts.

RHEL

grep -rsnH intel /etc/yum.repos.d/*
dnf repolist --all | grep -E "intel|igc|igsc|metee|xpu|level-zero"

Remove references to yum.repos.intel.com from the repository configuration to avoid version conflicts. Do not use the repository configuration for Intel® Data Center GPU Flex Series or Intel® Data Center GPU Max Series on newer hardware.

GPU access permissions

If you cannot access the GPU, check whether you belong to the group that owns the DRM render nodes.

1. Check the group assigned to the render nodes and your current group memberships.

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

2. If the output shows render as the group assigned to the render nodes and render is not listed in your group memberships, add your user to that group.

   sudo gpasswd -a ${USER} render
   

3. Start a shell with the render group active.

   newgrp render
   

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 System Management Interface