Install the Instinct Driver via package manager

Install the Instinct Driver via package manager#

2025-08-07

9 min read time

Applies to Linux

This page describes how to install the Instinct Driver using your Linux distribution’s package manager. Before installing, see the supported hardware and distros to make sure your system is compatible.

Important

Upgrades and downgrades are not supported. You must uninstall any existing ROCm installation before installing the preview build.

Prerequisites#

Before installing, complete the following prerequisites.

Install kernel headers.

sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)"

Install kernel headers.

sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)"

Install kernel headers.

sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)"

  1. Register your Enterprise Linux.

    subscription-manager register --username <username> --password <password>
subscription-manager attach --auto

  2. Update your Enterprise Linux.

    sudo dnf update --releasever=8.10 --exclude=\*release\*

  3. Install kernel headers.

    sudo dnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)"

  1. Register your Enterprise Linux.

    subscription-manager register --username <username> --password <password>
subscription-manager attach --auto

  2. Update your Enterprise Linux.

    sudo dnf update --releasever=9.4 --exclude=\*release\*

  3. Install kernel headers.

    sudo dnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)" "kernel-devel-matched-$(uname -r)"

  1. Register your Enterprise Linux.

    subscription-manager register --username <username> --password <password>
subscription-manager attach --auto

  2. Update your Enterprise Linux.

    sudo dnf update --releasever=9.6 --exclude=\*release\*

  3. Install kernel headers.

    sudo dnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)" "kernel-devel-matched-$(uname -r)"

  1. Update your Enterprise Linux.

    sudo dnf update --releasever=8.10 --exclude=\*release\*

  2. Install kernel headers.

    sudo dnf install "kernel-uek-devel-$(uname -r)"

  1. Update your Enterprise Linux.

    sudo dnf update --releasever=9.6 --exclude=\*release\*

  2. Install kernel headers.

    sudo dnf install "kernel-uek-devel-$(uname -r)"

  1. Register your Enterprise Linux.

    sudo SUSEConnect -r <REGCODE>

  2. Update your Enterprise Linux.

    sudo zypper update

  3. Install kernel headers.

    sudo zypper install kernel-default-devel

  1. Register your Enterprise Linux.

    sudo SUSEConnect -r <REGCODE>

  2. Update your Enterprise Linux.

    sudo zypper update

  3. Install kernel headers.

    sudo zypper install kernel-default-devel

Register ROCm repositories#

  1. Add the package signing key.

    # Make the directory if it doesn't exist yet.
# This location is recommended by the distribution maintainers.
sudo mkdir --parents --mode=0755 /etc/apt/keyrings
# Download the key, convert the signing-key to a full
# keyring required by apt and store in the keyring directory.
wget https://repo.radeon.com/rocm/rocm.gpg.key -O - | \
  gpg --dearmor | sudo tee /etc/apt/keyrings/rocm.gpg > /dev/null

  2. Register the kernel mode driver.

    echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/30.10_rc1/ubuntu jammy main" \
  | sudo tee /etc/apt/sources.list.d/amdgpu.list
sudo apt update

  1. Add the package signing key.

    # Make the directory if it doesn't exist yet.
# This location is recommended by the distribution maintainers.
sudo mkdir --parents --mode=0755 /etc/apt/keyrings
# Download the key, convert the signing-key to a full
# keyring required by apt and store in the keyring directory.
wget https://repo.radeon.com/rocm/rocm.gpg.key -O - | \
  gpg --dearmor | sudo tee /etc/apt/keyrings/rocm.gpg > /dev/null

  2. Register the kernel mode driver.

    echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/30.10_rc1/ubuntu noble main" \
  | sudo tee /etc/apt/sources.list.d/amdgpu.list
sudo apt update

  1. Add the package signing key.

    # Make the directory if it doesn't exist yet.
# This location is recommended by the distribution maintainers.
sudo mkdir --parents --mode=0755 /etc/apt/keyrings
# Download the key, convert the signing-key to a full
# keyring required by apt and store in the keyring directory.
wget https://repo.radeon.com/rocm/rocm.gpg.key -O - | \
  gpg --dearmor | sudo tee /etc/apt/keyrings/rocm.gpg > /dev/null

  2. Register the kernel mode driver.

    echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/30.10_rc1/ubuntu jammy main" \
  | sudo tee /etc/apt/sources.list.d/amdgpu.list
sudo apt update

sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
[amdgpu]
name=amdgpu
baseurl=https://repo.radeon.com/amdgpu/30.10_rc1/rhel/8.10/main/x86_64/
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo dnf clean all

sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
[amdgpu]
name=amdgpu
baseurl=https://repo.radeon.com/amdgpu/30.10_rc1/rhel/9.4/main/x86_64/
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo dnf clean all

sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
[amdgpu]
name=amdgpu
baseurl=https://repo.radeon.com/amdgpu/30.10_rc1/rhel/9.6/main/x86_64/
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo dnf clean all

sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
[amdgpu]
name=amdgpu
baseurl=https://repo.radeon.com/amdgpu/30.10_rc1/rhel/8.10/main/x86_64/
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo dnf clean all

sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
[amdgpu]
name=amdgpu
baseurl=https://repo.radeon.com/amdgpu/30.10_rc1/el/9.6/main/x86_64/
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo dnf clean all

sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
[amdgpu]
name=amdgpu
baseurl=https://repo.radeon.com/amdgpu/30.10_rc1/sle/15.6/main/x86_64/
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo zypper refresh

sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
[amdgpu]
name=amdgpu
baseurl=https://repo.radeon.com/amdgpu/30.10_rc1/sle/15.7/main/x86_64/
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo zypper refresh

Install the kernel driver#

sudo apt install amdgpu-dkms
sudo reboot

sudo apt install amdgpu-dkms
sudo reboot

sudo apt install amdgpu-dkms
sudo reboot

sudo dnf install amdgpu-dkms
sudo reboot

sudo dnf install amdgpu-dkms
sudo reboot

sudo dnf install amdgpu-dkms
sudo reboot

sudo dnf install amdgpu-dkms
sudo reboot

sudo dnf install amdgpu-dkms
sudo reboot

sudo zypper --gpg-auto-import-keys install amdgpu-dkms
sudo reboot

sudo zypper --gpg-auto-import-keys install amdgpu-dkms
sudo reboot

Uninstalling#

  1. Uninstall the kernel mode driver.

    sudo apt autoremove amdgpu-dkms

  2. Remove AMDGPU repositories.

    sudo rm /etc/apt/sources.list.d/amdgpu.list
# Clear the cache and clean the system
sudo rm -rf /var/cache/apt/*
sudo apt clean all
sudo apt update
# Restart the system
sudo reboot

  1. Uninstall the kernel mode driver.

    sudo apt autoremove amdgpu-dkms

  2. Remove AMDGPU repositories.

    sudo rm /etc/apt/sources.list.d/amdgpu.list
# Clear the cache and clean the system
sudo rm -rf /var/cache/apt/*
sudo apt clean all
sudo apt update
# Restart the system
sudo reboot

  1. Uninstall the kernel mode driver.

    sudo apt autoremove amdgpu-dkms

  2. Remove AMDGPU repositories.

    sudo rm /etc/apt/sources.list.d/amdgpu.list
# Clear the cache and clean the system
sudo rm -rf /var/cache/apt/*
sudo apt clean all
sudo apt update
# Restart the system
sudo reboot

  1. Uninstall the kernel mode driver.

    sudo dnf remove amdgpu-dkms

  2. Remove AMDGPU repositories.

    sudo rm /etc/yum.repos.d/amdgpu.repo
# Clear the cache and clean the system
sudo rm -rf /var/cache/dnf
sudo dnf clean all
# Restart the system
sudo reboot

  1. Uninstall the kernel mode driver.

    sudo dnf remove amdgpu-dkms

  2. Remove AMDGPU repositories.

    sudo rm /etc/yum.repos.d/amdgpu.repo
# Clear the cache and clean the system
sudo rm -rf /var/cache/dnf
sudo dnf clean all
# Restart the system
sudo reboot

  1. Uninstall the kernel mode driver.

    sudo dnf remove amdgpu-dkms

  2. Remove AMDGPU repositories.

    sudo rm /etc/yum.repos.d/amdgpu.repo
# Clear the cache and clean the system
sudo rm -rf /var/cache/dnf
sudo dnf clean all
# Restart the system
sudo reboot

  1. Uninstall the kernel mode driver.

    sudo dnf remove amdgpu-dkms

  2. Remove AMDGPU repositories.

    sudo rm /etc/yum.repos.d/amdgpu.repo
# Clear the cache and clean the system
sudo rm -rf /var/cache/dnf
sudo dnf clean all
# Restart the system
sudo reboot

  1. Uninstall the kernel mode driver.

    sudo dnf remove amdgpu-dkms

  2. Remove AMDGPU repositories.

    sudo rm /etc/yum.repos.d/amdgpu.repo
# Clear the cache and clean the system
sudo rm -rf /var/cache/dnf
sudo dnf clean all
# Restart the system
sudo reboot

  1. Uninstall the kernel mode driver.

    sudo zypper remove amdgpu-dkms amdgpu-dkms-firmware

  2. Remove AMDGPU repositories.

    sudo zypper removerepo "amdgpu"
# Clear the cache and clean the system
sudo zypper clean --all
sudo zypper refresh
# Restart the system
sudo reboot

  1. Uninstall the kernel mode driver.

    sudo zypper remove amdgpu-dkms amdgpu-dkms-firmware

  2. Remove AMDGPU repositories.

    sudo zypper removerepo "amdgpu"
# Clear the cache and clean the system
sudo zypper clean --all
sudo zypper refresh
# Restart the system
sudo reboot