This page is depreciated.
Please refer to the latest installation guide.
Ubuntu* 22.04 (jammy)
Driver installation instructions assume the Ubuntu Server 22.04.2 LTS is already installed. Refer to 3rd party instructions to load the distribution, if not already present.
If you need to update your GPU firmware, refer to the system’s Original Equipment Manufacturer (OEM) for the latest version.
Step 1 Add package repository
To install the repositories.intel.com/graphics package repository, add the
following to your Ubuntu installation. Prior to copy/pasting to your console,
you may want to run sudo ls
and enter your password to prevent the commands
from being swallowed by the sudo password prompt:
sudo apt-get install -y gpg-agent wget
wget -qO - https://repositories.intel.com/graphics/intel-graphics.key | \
sudo gpg --dearmor --output /usr/share/keyrings/intel-graphics.gpg
echo 'deb [arch=amd64 signed-by=/usr/share/keyrings/intel-graphics.gpg] https://repositories.intel.com/graphics/ubuntu jammy flex' | \
sudo tee /etc/apt/sources.list.d/intel.gpu.jammy.list
The above will make sure your system has gpg-agent and wget installed. It will then download and install the public key used to verify the integrity of the package repository. Finally, it adds the repositories.intel.com/graphics repository to the system.
Step 2 Install Linux kernel
Please install the 5.15.0-57 kernel (ie “linux-image-5.15.0-57-generic”).
sudo apt-get update && sudo apt-get install -y --install-suggests linux-image-5.15.0-57-generic
Update the kernel grub options
sudo sed -i "s/GRUB_DEFAULT=.*/GRUB_DEFAULT=\"1> $(echo $(($(awk -F\' '/menuentry / {print $2}' /boot/grub/grub.cfg \
| grep -no '5.15.0-57' | sed 's/:/\n/g' | head -n 1)-2)))\"/" /etc/default/grub
sudo sed -i "s/GRUB_CMDLINE_LINUX_DEFAULT=.*/GRUB_CMDLINE_LINUX_DEFAULT=\"$(echo $(awk -F'="' '$1 == "GRUB_CMDLINE_LINUX_DEFAULT" {print $2}' \
/etc/default/grub | tr -d '"') | sed 's/pci=realloc=off//g') pci=realloc=off\"/" /etc/default/grub
sudo update-grub
Reboot the system for these changes to take effect
sudo reboot
If you have enabled Secure Boot in the BIOS, you might get the prompt during the reboot.Please make sure you choose Enroll MOK to make the new kernel to be effective.
Please ensure you are using 5.15.0-57-generic. Then proceed with the below instructions.
uname -r
Install dkms and kernel header files
sudo apt-get update
sudo apt-get -y install \
gawk \
dkms \
linux-headers-$(uname -r) \
libc6-dev
Step 3 Install DKMS kernel modules
sudo apt-get install -y intel-platform-vsec-dkms intel-platform-cse-dkms
sudo apt-get install -y intel-i915-dkms intel-fw-gpu
Step 4 Install run-time packages
You can install the GPU software packages by running the following:
sudo apt-get install -y \
intel-opencl-icd intel-level-zero-gpu level-zero \
intel-media-va-driver-non-free libmfx1 libmfxgen1 libvpl2 \
libegl-mesa0 libegl1-mesa libegl1-mesa-dev libgbm1 libgl1-mesa-dev libgl1-mesa-dri \
libglapi-mesa libgles2-mesa-dev libglx-mesa0 libigdgmm12 libxatracker2 mesa-va-drivers \
mesa-vdpau-drivers mesa-vulkan-drivers va-driver-all vainfo
Intel OpenCL™ Offline Compiler (intel-ocloc) is included in intel-opencl-icd.
OPTIONAL: Install developer packages
If you will be doing development, you may want to install optional development packages. oneAPI users will need to install these packages for some of the oneAPI tools to function correctly:
sudo apt-get install -y \
libigc-dev \
intel-igc-cm \
libigdfcl-dev \
libigfxcmrt-dev \
level-zero-dev
Reboot the system for these changes to take effect
sudo reboot
Step 5 Configuring permissions
In order to access GPU capabilities, a user needs to have the correct permissions on system. The following will list the group assigned ownership of the render nodes, and list the groups the active user is a member of:
stat -c "%G" /dev/dri/render*
groups ${USER}
If a group is listed for the render node which isn’t listed for the user, you will need to add the user to the group using gpasswd. In the following, the active user will be added to the ‘render’ group and a new shell spawned with that group active:
sudo gpasswd -a ${USER} render
newgrp render
Step 6 Verify the installations
Verify the device is working with i915 driver
sudo apt-get install hwinfo
hwinfo --display
Similar information will be showed as below:
353: PCI d500.0: 0380 Display controller
[Created at pci.386]
Unique ID: bLlx.rxPVvg8q8pB
Parent ID: _bbG.mr2N3fBJq5F
SysFS ID: /devices/pci0000:c9/0000:c9:02.0/0000:ca:00.0/0000:cb:00.0/0000:cc:00.0/0000:cd:18.0/0000:d3:00.0/0000:d4:01.0/0000:d5:00.0
SysFS BusID: 0000:d5:00.0
Hardware Class: graphics card
Model: "Intel Display controller"
Vendor: pci 0x8086 "Intel Corporation"
Device: pci 0x56c1
SubVendor: pci 0x8086 "Intel Corporation"
SubDevice: pci 0x4905
Revision: 0x05
Driver: "i915"
Driver Modules: "i915"
Verify Media drivers installation
export DISPLAY=:0.0
vainfo
Similar information will be showed as below:
libva info: VA-API version 1.14.0
libva info: Trying to open /usr/lib/x86_64-linux-gnu/dri/iHD_drv_video.so
libva info: Found init function __vaDriverInit_1_14
libva info: va_openDriver() returns 0
vainfo: VA-API version: 1.14 (libva 2.12.0)
Verify Computing drivers installation
sudo apt-get install clinfo
clinfo
Similar information will be showed as below:
Number of platforms 2
Platform Name Intel(R) OpenCL HD Graphics
Platform Vendor Intel(R) Corporation
Platform Version OpenCL 3.0
Platform Profile FULL_PROFILE