mirror of
https://github.com/ROCm/ROCm.git
synced 2026-02-11 23:15:06 -05:00
e3e924cf00
* fix release date and known issue * add llama.cpp known issue and fix link to amdgpu 31.10.0 * docs: minor fixes * fx * clean up known issues * clean up
1042 lines
33 KiB
ReStructuredText
1042 lines
33 KiB
ReStructuredText
Installation
|
|
============
|
|
|
|
.. dropdown:: Installation environment
|
|
:animate: fade-in-slide-down
|
|
:icon: desktop-download
|
|
:chevron: down-up
|
|
|
|
.. include:: ./includes/selector.rst
|
|
|
|
Before getting started, make sure you've completed the :ref:`rocm-prerequisites`.
|
|
For information about supported operating systems and compatible AMD devices,
|
|
see the :doc:`Compatibility matrix </compatibility/compatibility-matrix>`.
|
|
|
|
.. selected:: os=windows
|
|
|
|
.. caution::
|
|
|
|
Do not copy/replace the ROCm compiler and runtime DLLs to System32 as
|
|
this can cause conflicts.
|
|
|
|
.. ==================================================== INSTALL KERNEL DRIVER ==
|
|
|
|
.. selected:: fam=instinct fam=radeon-pro fam=radeon
|
|
:heading: Install kernel driver
|
|
:heading-level: 3
|
|
|
|
For information about AMD GPU Driver (amdgpu) compatibility, see the
|
|
:doc:`Compatibility matrix </compatibility/compatibility-matrix>`.
|
|
|
|
.. selected:: os=ubuntu
|
|
|
|
For instructions on installing the AMD GPU Driver (amdgpu), see `Ubuntu native
|
|
installation
|
|
<https://instinct.docs.amd.com/projects/amdgpu-docs/en/31.10.0-preview/install/detailed-install/package-manager/package-manager-ubuntu.html>`__
|
|
in the AMD Instinct Data Center GPU Documentation.
|
|
|
|
.. selected:: os=debian
|
|
|
|
For instructions on installing the AMD GPU Driver (amdgpu), see `Debian native
|
|
installation
|
|
<https://instinct.docs.amd.com/projects/amdgpu-docs/en/31.10.0-preview/install/detailed-install/package-manager/package-manager-debian.html>`__
|
|
in the AMD Instinct Data Center GPU Documentation.
|
|
|
|
.. selected:: os=rhel
|
|
|
|
For instructions on installing the AMD GPU Driver (amdgpu), see `RHEL native
|
|
installation
|
|
<https://instinct.docs.amd.com/projects/amdgpu-docs/en/31.10.0-preview/install/detailed-install/package-manager/package-manager-rhel.html>`__
|
|
in the AMD Instinct Data Center GPU Documentation.
|
|
|
|
.. selected:: os=oracle-linux
|
|
|
|
For instructions on installing the AMD GPU Driver (amdgpu), see `Oracle Linux native
|
|
installation
|
|
<https://instinct.docs.amd.com/projects/amdgpu-docs/en/31.10.0-preview/install/detailed-install/package-manager/package-manager-ol.html>`__
|
|
in the AMD Instinct Data Center GPU Documentation.
|
|
|
|
.. selected:: os=rocky-linux
|
|
|
|
For instructions on installing the AMD GPU Driver (amdgpu), see `Rocky Linux native
|
|
installation
|
|
<https://instinct.docs.amd.com/projects/amdgpu-docs/en/31.10.0-preview/install/detailed-install/package-manager/package-manager-rl.html>`__
|
|
in the AMD Instinct Data Center GPU Documentation.
|
|
|
|
.. selected:: os=sles
|
|
|
|
For instructions on installing the AMD GPU Driver (amdgpu), see `SLES
|
|
native installation
|
|
<https://instinct.docs.amd.com/projects/amdgpu-docs/en/31.10.0-preview/install/detailed-install/package-manager/package-manager-sles.html>`__
|
|
in the AMD Instinct Data Center GPU Documentation.
|
|
|
|
.. selected:: fam=ryzen
|
|
|
|
.. selected:: os=ubuntu
|
|
:heading: About the kernel driver
|
|
:heading-level: 3
|
|
|
|
Supported Ryzen AI APUs require the inbox kernel driver included with
|
|
Ubuntu 24.04.3.
|
|
|
|
Install the ROCm Core SDK
|
|
-------------------------
|
|
|
|
Use the following instructions to install the ROCm Core SDK on your system.
|
|
|
|
.. ========================================================== PACKAGE MANAGER ==
|
|
|
|
.. selected:: i=pkgman
|
|
:heading: Register ROCm repositories
|
|
:heading-level: 4
|
|
|
|
.. selected:: os=ubuntu
|
|
|
|
Register the ROCm repository with your system's package manager. This lets you install and update
|
|
ROCm packages using ``apt``.
|
|
|
|
.. selected:: os-version=24.04
|
|
|
|
.. code-block:: bash
|
|
|
|
# Download and install GPG key
|
|
sudo mkdir --parents --mode=0755 /etc/apt/keyrings
|
|
wget https://repo.amd.com/rocm/packages/gpg/rocm.gpg -O - | \
|
|
gpg --dearmor | sudo tee /etc/apt/keyrings/amdrocm.gpg > /dev/null
|
|
|
|
sudo tee /etc/apt/sources.list.d/rocm.list << EOF
|
|
deb [arch=amd64 signed-by=/etc/apt/keyrings/amdrocm.gpg] https://repo.amd.com/rocm/packages/ubuntu2404 stable main
|
|
EOF
|
|
|
|
sudo apt update
|
|
|
|
.. selected:: os-version=22.04
|
|
|
|
.. code-block:: bash
|
|
|
|
# Download and install GPG key
|
|
sudo mkdir --parents --mode=0755 /etc/apt/keyrings
|
|
wget https://repo.amd.com/rocm/packages/gpg/rocm.gpg -O - | \
|
|
gpg --dearmor | sudo tee /etc/apt/keyrings/amdrocm.gpg > /dev/null
|
|
|
|
sudo tee /etc/apt/sources.list.d/rocm.list << EOF
|
|
deb [arch=amd64 signed-by=/etc/apt/keyrings/amdrocm.gpg] https://repo.amd.com/rocm/packages/ubuntu2204 stable main
|
|
EOF
|
|
|
|
sudo apt update
|
|
|
|
.. selected:: os=debian
|
|
|
|
Register the ROCm repository with your system's package manager. This enables
|
|
you to install and update ROCm packages using ``apt``.
|
|
|
|
.. code-block:: bash
|
|
|
|
# Download and install GPG key
|
|
sudo mkdir --parents --mode=0755 /etc/apt/keyrings
|
|
wget https://repo.amd.com/rocm/packages/gpg/rocm.gpg -O - | \
|
|
gpg --dearmor | sudo tee /etc/apt/keyrings/amdrocm.gpg > /dev/null
|
|
|
|
sudo tee /etc/apt/sources.list.d/rocm.list << EOF
|
|
deb [arch=amd64 signed-by=/etc/apt/keyrings/amdrocm.gpg] https://repo.amd.com/rocm/packages/debian13 stable main
|
|
EOF
|
|
|
|
sudo apt update
|
|
|
|
.. selected:: os=rhel os=oracle-linux os=rocky-linux
|
|
|
|
.. selected:: os-version=10.1 os-version=10.0
|
|
|
|
Register the ROCm repository with your system's package manager. This enables
|
|
you to install and update ROCm packages using ``dnf``.
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo tee /etc/yum.repos.d/rocm.repo <<EOF
|
|
[rocm]
|
|
name=ROCm 7.11.0
|
|
baseurl=https://repo.amd.com/rocm/packages/rhel10/x86_64
|
|
enabled=1
|
|
gpgcheck=1
|
|
gpgkey=https://repo.amd.com/rocm/packages/gpg/rocm.gpg
|
|
priority=50
|
|
EOF
|
|
|
|
sudo dnf clean all
|
|
|
|
.. selected:: os-version=9.7 os-version=9.6 os-version=9.4
|
|
|
|
Register the ROCm repository with your system's package manager. This enables
|
|
you to install and update ROCm packages using ``dnf``.
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo tee /etc/yum.repos.d/rocm.repo <<EOF
|
|
[rocm]
|
|
name=ROCm 7.11.0
|
|
baseurl=https://repo.amd.com/rocm/packages/rhel9/x86_64
|
|
enabled=1
|
|
gpgcheck=1
|
|
gpgkey=https://repo.amd.com/rocm/packages/gpg/rocm.gpg
|
|
priority=50
|
|
EOF
|
|
|
|
sudo dnf clean all
|
|
|
|
|
|
.. selected:: os-version=8.10
|
|
|
|
Register the ROCm repository with your system's package manager. This enables
|
|
you to install and update ROCm packages using ``dnf``.
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo tee /etc/yum.repos.d/rocm.repo <<EOF
|
|
[rocm]
|
|
name=ROCm 7.11.0
|
|
baseurl=https://repo.amd.com/rocm/packages/rhel8/x86_64
|
|
enabled=1
|
|
gpgcheck=1
|
|
gpgkey=https://repo.amd.com/rocm/packages/gpg/rocm.gpg
|
|
priority=50
|
|
EOF
|
|
|
|
sudo dnf clean all
|
|
|
|
.. selected:: os=sles
|
|
|
|
Register the ROCm repository with your system's package manager. This enables
|
|
you to install and update ROCm packages using ``zypper``.
|
|
|
|
.. selected:: os-version=16.0
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo tee /etc/zypp/repos.d/rocm.repo <<EOF
|
|
[rocm]
|
|
name=ROCm 7.11.0
|
|
baseurl=https://repo.amd.com/rocm/packages/sles16/x86_64
|
|
enabled=1
|
|
gpgcheck=1
|
|
gpgkey=https://repo.amd.com/rocm/packages/gpg/rocm.gpg
|
|
priority=50
|
|
EOF
|
|
|
|
sudo zypper refresh
|
|
|
|
.. selected:: os-version=15.7
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo tee /etc/zypp/repos.d/rocm.repo <<EOF
|
|
[rocm]
|
|
name=ROCm 7.11.0
|
|
baseurl=https://repo.amd.com/rocm/packages/sles15/x86_64
|
|
enabled=1
|
|
gpgcheck=1
|
|
gpgkey=https://repo.amd.com/rocm/packages/gpg/rocm.gpg
|
|
priority=50
|
|
EOF
|
|
|
|
sudo zypper refresh
|
|
|
|
.. selected:: i=pkgman
|
|
:heading: Install ROCm packages
|
|
:heading-level: 4
|
|
|
|
.. selected:: os=ubuntu os=debian
|
|
|
|
Use ``apt`` to install the core ROCm packages. See :ref:`ROCm meta
|
|
packages <rocm-install-meta-packages>` for additional installation
|
|
options.
|
|
|
|
.. selected:: gpu=mi355x gpu=mi350x
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt install amdrocm7.11-gfx950
|
|
|
|
.. selected:: gpu=mi325x gpu=mi300x gpu=mi300a
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt install amdrocm7.11-gfx94x
|
|
|
|
.. selected:: gpu=mi250x gpu=mi250 gpu=mi210
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt install amdrocm7.11-gfx90x
|
|
|
|
.. selected:: gpu=ai-r9700 gpu=ai-r9600d gpu=rx-9070-xt gpu=rx-9070-gre gpu=rx-9070 gpu=rx-9060-xt-lp gpu=rx-9060-xt gpu=rx-9060
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt install amdrocm7.11-gfx120x
|
|
|
|
.. selected:: gpu=w7900-dual-slot gpu=w7900 gpu=w7800-48gb gpu=w7800 gpu=w7700 gpu=v710 gpu=rx-7900-xtx gpu=rx-7900-xt gpu=rx-7900-gre gpu=rx-7800-xt gpu=rx-7700-xt gpu=rx-7700
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt install amdrocm7.11-gfx110x
|
|
|
|
.. selected:: gpu=w6800 gpu=v620
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt install amdrocm7.11-gfx103x
|
|
|
|
.. selected:: gpu=max-pro-395 gpu=max-pro-390 gpu=max-pro-385 gpu=max-pro-380 gpu=max-395 gpu=max-390 gpu=max-385
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt install amdrocm7.11-gfx1151
|
|
|
|
.. selected:: gpu=9-hx-375 gpu=9-hx-370 gpu=9-365
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt install amdrocm7.11-gfx1150
|
|
|
|
.. selected:: os=rhel os=oracle-linux os=rocky-linux
|
|
|
|
Use ``dnf`` to install the core ROCm packages. See :ref:`ROCm meta
|
|
packages <rocm-install-meta-packages>` for additional installation
|
|
options.
|
|
|
|
.. selected:: gpu=mi355x gpu=mi350x
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo dnf install amdrocm7.11-gfx950
|
|
|
|
.. selected:: gpu=mi325x gpu=mi300x gpu=mi300a
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo dnf install amdrocm7.11-gfx94x
|
|
|
|
.. selected:: gpu=mi250x gpu=mi250 gpu=mi210
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo dnf install amdrocm7.11-gfx90x
|
|
|
|
.. selected:: gpu=ai-r9700 gpu=ai-r9600d gpu=rx-9070-xt gpu=rx-9070-gre gpu=rx-9070 gpu=rx-9060-xt-lp gpu=rx-9060-xt gpu=rx-9060
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo dnf install amdrocm7.11-gfx120x
|
|
|
|
.. selected:: gpu=w7900-dual-slot gpu=w7900 gpu=w7800-48gb gpu=w7800 gpu=w7700 gpu=v710 gpu=rx-7900-xtx gpu=rx-7900-xt gpu=rx-7900-gre gpu=rx-7800-xt gpu=rx-7700-xt gpu=rx-7700
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo dnf install amdrocm7.11-gfx110x
|
|
|
|
.. selected:: gpu=w6800 gpu=v620
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo dnf install amdrocm7.11-gfx103x
|
|
|
|
.. selected:: os=sles
|
|
|
|
Use ``zypper`` to install the core ROCm packages. See :ref:`ROCm meta
|
|
packages <rocm-install-meta-packages>` for additional installation
|
|
options.
|
|
|
|
.. selected:: gpu=mi355x gpu=mi350x
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo zypper install amdrocm7.11-gfx950
|
|
|
|
.. selected:: gpu=mi325x gpu=mi300x gpu=mi300a
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo zypper install amdrocm7.11-gfx94x
|
|
|
|
.. selected:: gpu=mi250x gpu=mi250 gpu=mi210
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo zypper install amdrocm7.11-gfx90x
|
|
|
|
.. ============================================================ META PACKAGES ==
|
|
|
|
.. selected:: i=pkgman
|
|
:heading: ROCm meta packages
|
|
:heading-level: 5
|
|
|
|
.. _rocm-install-meta-packages:
|
|
|
|
Meta packages group related components and dependencies together, allowing
|
|
you to install only what is necessary for your use case. The following table
|
|
describes available ROCm meta packages:
|
|
|
|
.. matrix::
|
|
|
|
.. matrix-row::
|
|
:header:
|
|
|
|
.. matrix-cell:: Meta package name
|
|
|
|
.. matrix-cell:: Contents
|
|
|
|
.. matrix-cell:: Use case
|
|
|
|
.. matrix-row::
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=mi355x gpu=mi350x
|
|
|
|
``amdrocm7.11-gfx950``
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=mi325x gpu=mi300x gpu=mi300a
|
|
|
|
``amdrocm7.11-gfx94x``
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=mi250x gpu=mi250 gpu=mi210
|
|
|
|
``amdrocm7.11-gfx90x``
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=ai-r9700 gpu=ai-r9600d gpu=rx-9070-xt gpu=rx-9070-gre gpu=rx-9070 gpu=rx-9060-xt-lp gpu=rx-9060-xt gpu=rx-9060
|
|
|
|
``amdrocm7.11-gfx120x``
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=w7900-dual-slot gpu=w7900 gpu=w7800-48gb gpu=w7800 gpu=w7700 gpu=v710 gpu=rx-7900-xtx gpu=rx-7900-xt gpu=rx-7900-gre gpu=rx-7800-xt gpu=rx-7700-xt gpu=rx-7700
|
|
|
|
``amdrocm7.11-gfx110x``
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=w6800 gpu=v620
|
|
|
|
``amdrocm7.11-gfx103x``
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=max-pro-395 gpu=max-pro-390 gpu=max-pro-385 gpu=max-pro-380 gpu=max-395 gpu=max-390 gpu=max-385
|
|
|
|
``amdrocm7.11-gfx1151``
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=9-hx-375 gpu=9-hx-370 gpu=9-365
|
|
|
|
``amdrocm7.11-gfx1150``
|
|
|
|
.. matrix-cell:: Runtimes, libraries, system control and monitoring tools, and other essential components.
|
|
|
|
.. matrix-cell::
|
|
|
|
Core runtime environment.
|
|
|
|
Install this to run ROCm applications.
|
|
|
|
.. matrix-row::
|
|
|
|
.. matrix-cell::
|
|
:show-when: os=ubuntu os=debian
|
|
|
|
.. selected:: gpu=mi355x gpu=mi350x
|
|
|
|
``amdrocm-core-dev7.11-gfx950``
|
|
|
|
.. selected:: gpu=mi325x gpu=mi300x gpu=mi300a
|
|
|
|
``amdrocm-core-dev7.11-gfx94x``
|
|
|
|
.. selected:: gpu=mi250x gpu=mi250 gpu=mi210
|
|
|
|
``amdrocm-core-dev7.11-gfx90x``
|
|
|
|
.. selected:: gpu=ai-r9700 gpu=ai-r9600d gpu=rx-9070-xt gpu=rx-9070-gre gpu=rx-9070 gpu=rx-9060-xt-lp gpu=rx-9060-xt gpu=rx-9060
|
|
|
|
``amdrocm-core-dev7.11-gfx120x``
|
|
|
|
.. selected:: gpu=w7900-dual-slot gpu=w7900 gpu=w7800-48gb gpu=w7800 gpu=w7700 gpu=v710 gpu=rx-7900-xtx gpu=rx-7900-xt gpu=rx-7900-gre gpu=rx-7800-xt gpu=rx-7700-xt gpu=rx-7700
|
|
|
|
``amdrocm-core-dev7.11-gfx110x``
|
|
|
|
.. selected:: gpu=w6800 gpu=v620
|
|
|
|
``amdrocm-core-dev7.11-gfx103x``
|
|
|
|
.. selected:: gpu=max-pro-395 gpu=max-pro-390 gpu=max-pro-385 gpu=max-pro-380 gpu=max-395 gpu=max-390 gpu=max-385
|
|
|
|
``amdrocm-core-dev7.11-gfx1151``
|
|
|
|
.. selected:: gpu=9-hx-375 gpu=9-hx-370 gpu=9-365
|
|
|
|
``amdrocm-core-dev7.11-gfx1150``
|
|
|
|
.. matrix-cell::
|
|
:show-when: os=rhel os=oracle-linux os=rocky-linux os=sles
|
|
|
|
.. selected:: gpu=mi355x gpu=mi350x
|
|
|
|
``amdrocm-core-devel7.11-gfx950``
|
|
|
|
.. selected:: gpu=mi325x gpu=mi300x gpu=mi300a
|
|
|
|
``amdrocm-core-devel7.11-gfx94x``
|
|
|
|
.. selected:: gpu=mi250x gpu=mi250 gpu=mi210
|
|
|
|
``amdrocm-core-devel7.11-gfx90x``
|
|
|
|
.. selected:: gpu=ai-r9700 gpu=ai-r9600d gpu=rx-9070-xt gpu=rx-9070-gre gpu=rx-9070 gpu=rx-9060-xt-lp gpu=rx-9060-xt gpu=rx-9060
|
|
|
|
``amdrocm-core-devel7.11-gfx120x``
|
|
|
|
.. selected:: gpu=w7900-dual-slot gpu=w7900 gpu=w7800-48gb gpu=w7800 gpu=w7700 gpu=v710 gpu=rx-7900-xtx gpu=rx-7900-xt gpu=rx-7900-gre gpu=rx-7800-xt gpu=rx-7700-xt gpu=rx-7700
|
|
|
|
``amdrocm-core-devel7.11-gfx110x``
|
|
|
|
.. selected:: gpu=w6800 gpu=v620
|
|
|
|
``amdrocm-core-devel7.11-gfx103x``
|
|
|
|
.. selected:: gpu=max-pro-395 gpu=max-pro-390 gpu=max-pro-385 gpu=max-pro-380 gpu=max-395 gpu=max-390 gpu=max-385
|
|
|
|
``amdrocm-core-devel7.11-gfx1151``
|
|
|
|
.. selected:: gpu=9-hx-375 gpu=9-hx-370 gpu=9-365
|
|
|
|
``amdrocm-core-devel7.11-gfx1150``
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=mi355x gpu=mi350x
|
|
|
|
``amdrocm7.11-gfx950`` plus compilers, CMake configurations, static library files, and headers.
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=mi325x gpu=mi300x gpu=mi300a
|
|
|
|
``amdrocm7.11-gfx94x`` plus compilers, CMake configurations, static library files, and headers.
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=mi250x gpu=mi250 gpu=mi210
|
|
|
|
``amdrocm7.11-gfx90x`` plus compilers, CMake configurations, static library files, and headers.
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=ai-r9700 gpu=ai-r9600d gpu=rx-9070-xt gpu=rx-9070-gre gpu=rx-9070 gpu=rx-9060-xt-lp gpu=rx-9060-xt gpu=rx-9060
|
|
|
|
``amdrocm7.11-gfx120x`` plus compilers, CMake configurations, static library files, and headers.
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=w7900-dual-slot gpu=w7900 gpu=w7800-48gb gpu=w7800 gpu=w7700 gpu=v710 gpu=rx-7900-xtx gpu=rx-7900-xt gpu=rx-7900-gre gpu=rx-7800-xt gpu=rx-7700-xt gpu=rx-7700
|
|
|
|
``amdrocm7.11-gfx110x`` plus compilers, CMake configurations, static library files, and headers.
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=w6800 gpu=v620
|
|
|
|
``amdrocm7.11-gfx103x`` plus compilers, CMake configurations, static library files, and headers.
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=max-pro-395 gpu=max-pro-390 gpu=max-pro-385 gpu=max-pro-380 gpu=max-395 gpu=max-390 gpu=max-385
|
|
|
|
``amdrocm7.11-gfx1151`` plus compilers, CMake configurations, static library files, and headers.
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=9-hx-375 gpu=9-hx-370 gpu=9-365
|
|
|
|
``amdrocm7.11-gfx1150`` plus compilers, CMake configurations, static library files, and headers.
|
|
|
|
.. matrix-cell::
|
|
|
|
Development environment.
|
|
|
|
Install this to build ROCm applications.
|
|
|
|
.. matrix-row::
|
|
|
|
.. matrix-cell::
|
|
|
|
``amdrocm-developer-tools7.11``
|
|
|
|
.. matrix-cell:: Profilers, debuggers, and related tools.
|
|
|
|
.. matrix-cell:: Install this to profile, debug, and optimize ROCm applications.
|
|
|
|
.. matrix-row::
|
|
|
|
.. matrix-cell::
|
|
|
|
``amdrocm-opencl7.11``
|
|
|
|
.. matrix-cell:: Components needed to run OpenCL.
|
|
|
|
.. matrix-cell:: Install this to run OpenCL applications on ROCm.
|
|
|
|
.. matrix-row::
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=mi355x gpu=mi350x
|
|
|
|
``amdrocm-core-sdk-gfx950``
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=mi325x gpu=mi300x gpu=mi300a
|
|
|
|
``amdrocm-core-sdk-gfx94x``
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=mi250x gpu=mi250 gpu=mi210
|
|
|
|
``amdrocm-core-sdk-gfx90x``
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=ai-r9700 gpu=ai-r9600d gpu=rx-9070-xt gpu=rx-9070-gre gpu=rx-9070 gpu=rx-9060-xt-lp gpu=rx-9060-xt gpu=rx-9060
|
|
|
|
``amdrocm-core-sdk-gfx120x``
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=w7900-dual-slot gpu=w7900 gpu=w7800-48gb gpu=w7800 gpu=w7700 gpu=v710 gpu=rx-7900-xtx gpu=rx-7900-xt gpu=rx-7900-gre gpu=rx-7800-xt gpu=rx-7700-xt gpu=rx-7700
|
|
|
|
``amdrocm-core-sdk-gfx110x``
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=w6800 gpu=v620
|
|
|
|
``amdrocm-core-sdk-gfx103x``
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=max-pro-395 gpu=max-pro-390 gpu=max-pro-385 gpu=max-pro-380 gpu=max-395 gpu=max-390 gpu=max-385
|
|
|
|
``amdrocm-core-sdk-gfx1151``
|
|
|
|
.. matrix-cell::
|
|
:show-when: gpu=9-hx-375 gpu=9-hx-370 gpu=9-365
|
|
|
|
``amdrocm-core-sdk-gfx1150``
|
|
|
|
.. matrix-cell:: The complete ROCm Core SDK including runtimes, compilers, development tools, and dependencies.
|
|
|
|
.. matrix-cell:: Install this if you need everything.
|
|
|
|
.. ====================================================================== PIP ==
|
|
|
|
.. selected:: i=pip
|
|
:heading: Set up your Python virtual environment
|
|
:heading-level: 4
|
|
|
|
Create and activate the Python virtual environment where you'll install
|
|
ROCm packages.
|
|
|
|
.. selected:: os=ubuntu
|
|
|
|
.. selected:: os-version=24.04
|
|
|
|
For example, to create and activate a Python 3.12 virtual environment,
|
|
run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python3.12 -m venv .venv
|
|
source .venv/bin/activate
|
|
|
|
.. selected:: os-version=22.04
|
|
|
|
For example, to create and activate a Python 3.11 virtual environment,
|
|
run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python3.11 -m venv .venv
|
|
source .venv/bin/activate
|
|
|
|
.. selected:: os=debian
|
|
|
|
.. selected:: os-version=13
|
|
|
|
For example, to create and activate a Python 3.13 virtual environment,
|
|
run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python3.13 -m venv .venv
|
|
source .venv/bin/activate
|
|
|
|
.. selected:: os-version=22.04
|
|
|
|
For example, to create and activate a Python 3.11 virtual environment,
|
|
run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python3.11 -m venv .venv
|
|
source .venv/bin/activate
|
|
|
|
.. selected:: os=rhel os=oracle-linux os=rocky-linux
|
|
|
|
.. selected:: os-version=10.1 os-version=10.0
|
|
|
|
For example, to create and activate a Python 3.12 virtual environment,
|
|
run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python3.12 -m venv .venv
|
|
source .venv/bin/activate
|
|
|
|
.. selected:: os-version=9.7 os-version=9.6
|
|
|
|
For example, to create and activate a Python 3.11 virtual environment,
|
|
run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python3.11 -m venv .venv
|
|
source .venv/bin/activate
|
|
|
|
.. selected:: os-version=8.10
|
|
|
|
For example, to create and activate a Python 3.11 virtual environment,
|
|
run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python3.11 -m venv .venv
|
|
source .venv/bin/activate
|
|
|
|
.. selected:: os=sles
|
|
|
|
.. selected:: os-version=16.0
|
|
|
|
For example, to create and activate a Python 3.13 virtual environment,
|
|
run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python3.13 -m venv .venv
|
|
source .venv/bin/activate
|
|
|
|
.. selected:: os-version=15.7
|
|
|
|
For example, to create and activate a Python 3.11 virtual environment,
|
|
run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python3.11 -m venv .venv
|
|
source .venv/bin/activate
|
|
|
|
.. selected:: os=windows
|
|
|
|
For example, to create and activate a Python 3.12 virtual environment,
|
|
run the following command:
|
|
|
|
.. code-block:: bat
|
|
|
|
py -3.12 -m venv .venv
|
|
.venv\Scripts\activate
|
|
|
|
.. selected:: i=pip
|
|
:heading: Install ROCm wheel packages
|
|
:heading-level: 4
|
|
|
|
.. selected:: gpu=mi355x gpu=mi350x
|
|
|
|
Use pip to install the ROCm Core SDK libraries and development tools for
|
|
your ``gfx950`` GPU.
|
|
|
|
Run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx950-dcgpu/ "rocm[libraries,devel]"
|
|
|
|
.. selected:: gpu=mi325x gpu=mi300x gpu=mi300a
|
|
|
|
Use pip to install the ROCm Core SDK libraries and development tools for
|
|
your ``gfx942`` device.
|
|
|
|
Run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx94X-dcgpu/ "rocm[libraries,devel]"
|
|
|
|
.. selected:: gpu=mi250x gpu=mi250 gpu=mi210
|
|
|
|
Use pip to install the ROCm Core SDK libraries and development tools for
|
|
your ``gfx90a`` GPU.
|
|
|
|
Run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx90X-dcgpu/ "rocm[libraries,devel]"
|
|
|
|
.. selected:: gpu=ai-r9700 gpu=ai-r9600d gpu=rx-9070-xt gpu=rx-9070-gre gpu=rx-9070
|
|
|
|
Use pip to install the ROCm Core SDK libraries and development tools for
|
|
your ``gfx1201`` GPU.
|
|
|
|
Run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx120x-all/ "rocm[libraries,devel]"
|
|
|
|
.. selected:: gpu=rx-9060-xt-lp gpu=rx-9060-xt gpu=rx-9060
|
|
|
|
Use pip to install the ROCm Core SDK libraries and development tools for
|
|
your ``gfx1200`` GPU.
|
|
|
|
Run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx120x-all/ "rocm[libraries,devel]"
|
|
|
|
.. selected:: gpu=w7900-dual-slot gpu=w7900 gpu=w7800-48gb gpu=w7800 gpu=w7700 gpu=v710 gpu=rx-7900-xtx gpu=rx-7900 gpu=rx-7900-gre
|
|
|
|
Use pip to install the ROCm Core SDK libraries and development tools for
|
|
your ``gfx1100`` GPU.
|
|
|
|
Run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx110X-all/ "rocm[libraries,devel]"
|
|
|
|
.. selected:: gpu=w7700 gpu=v710 gpu=rx-7800-xt gpu=rx-7700-xt gpu=rx-7700
|
|
|
|
Use pip to install the ROCm Core SDK libraries and development tools for
|
|
your ``gfx1101`` GPU.
|
|
|
|
Run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx110X-all/ "rocm[libraries,devel]"
|
|
|
|
.. selected:: gpu=w6800 gpu=v620
|
|
|
|
Use pip to install the ROCm Core SDK libraries and development tools for
|
|
your ``gfx1030`` GPU.
|
|
|
|
Run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx103X-dgpu/ "rocm[libraries,devel]"
|
|
|
|
.. selected:: gpu=max-pro-395 gpu=max-pro-390 gpu=max-pro-385 gpu=max-pro-380 gpu=max-395 gpu=max-390 gpu=max-385
|
|
|
|
Use pip to install the ROCm Core SDK libraries and development tools for
|
|
your ``gfx1151`` Ryzen APU.
|
|
|
|
Run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1151/ "rocm[libraries,devel]"
|
|
|
|
.. selected:: gpu=9-hx-375 gpu=9-hx-370 gpu=9-365
|
|
|
|
Use pip to install the ROCm Core SDK libraries and development tools for
|
|
your ``gfx1150`` Ryzen APU.
|
|
|
|
Run the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1150/ "rocm[libraries,devel]"
|
|
|
|
.. ================================================================== TARBALL ==
|
|
|
|
.. selected:: i=tar
|
|
:heading: Create the installation directory
|
|
:heading-level: 4
|
|
|
|
.. selected:: os=ubuntu os=debian os=rhel os=oracle-linux os=rocky-linux os=sles
|
|
|
|
Run the following command in your desired location to create your
|
|
installation directory:
|
|
|
|
.. code-block:: bash
|
|
|
|
mkdir therock-tarball && cd therock-tarball
|
|
|
|
.. important::
|
|
|
|
Subsequent commands assume you're working with the ``therock-tarball``
|
|
directory. If you choose a different directory name, adjust the
|
|
commands accordingly.
|
|
|
|
|
|
.. selected:: os=windows
|
|
|
|
Create the installation directory in ``C:\TheRock\build``. For example,
|
|
use the following command in your command prompt:
|
|
|
|
.. code-block:: cmd
|
|
|
|
mkdir C:\TheRock\build
|
|
|
|
.. important::
|
|
|
|
Subsequent commands assume you're working with the
|
|
``C:\TheRock\build`` directory. If you choose a different directory
|
|
name, adjust the commands accordingly.
|
|
|
|
.. selected:: i=tar
|
|
:heading: Download and unpack the tarball
|
|
:heading-level: 4
|
|
|
|
.. selected:: os=ubuntu os=debian os=rhel os=oracle-linux os=rocky-linux os=sles
|
|
|
|
.. selected:: gpu=mi355x gpu=mi350x
|
|
|
|
Use the following commands to download and untar the ROCm tarball for
|
|
your ``gfx950`` GPU.
|
|
|
|
.. code-block:: bash
|
|
|
|
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx950-dcgpu-7.11.0.tar.gz
|
|
mkdir install
|
|
tar -xf *.tar.gz -C install
|
|
|
|
.. selected:: gpu=mi325x gpu=mi300x gpu=mi300a
|
|
|
|
Use the following commands to download and untar the ROCm tarball for
|
|
your ``gfx942`` GPU.
|
|
|
|
.. code-block:: bash
|
|
|
|
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx94X-dcgpu-7.11.0.tar.gz
|
|
mkdir install
|
|
tar -xf *.tar.gz -C install
|
|
|
|
.. selected:: gpu=mi250x gpu=mi250 gpu=mi210
|
|
|
|
Use the following commands to download and untar the ROCm tarball for
|
|
your ``gfx90a`` GPU.
|
|
|
|
.. code-block:: bash
|
|
|
|
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx90X-dcgpu-7.11.0.tar.gz
|
|
mkdir install
|
|
tar -xf *.tar.gz -C install
|
|
|
|
.. selected:: gpu=ai-r9700 gpu=ai-r9600d gpu=rx-9070-xt gpu=rx-9070-gre gpu=rx-9070 gpu=rx-9060-xt-lp gpu=rx-9060-xt gpu=rx-9060
|
|
|
|
Use the following commands to download and untar the ROCm tarball.
|
|
|
|
.. code-block:: bash
|
|
|
|
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx120X-all-7.11.0.tar.gz
|
|
mkdir install
|
|
tar -xf *.tar.gz -C install
|
|
|
|
.. selected:: gpu=w7900-dual-slot gpu=w7900 gpu=w7800-48gb gpu=w7800 gpu=w7700 gpu=v710
|
|
|
|
Use the following commands to download and untar the ROCm tarball.
|
|
|
|
.. code-block:: bash
|
|
|
|
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx110X-all-7.11.0.tar.gz
|
|
mkdir install
|
|
tar -xf *.tar.gz -C install
|
|
|
|
.. selected:: gpu=w6800 gpu=v620
|
|
|
|
Use the following commands to download and untar the ROCm tarball.
|
|
|
|
.. code-block:: bash
|
|
|
|
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx103X-dgpu-7.11.0.tar.gz
|
|
mkdir install
|
|
tar -xf *.tar.gz -C install
|
|
|
|
.. selected:: gpu=max-pro-395 gpu=max-pro-390 gpu=max-pro-385 gpu=max-pro-380 gpu=max-395 gpu=max-390 gpu=max-385
|
|
|
|
Use the following commands to download and untar the ROCm tarball for
|
|
your ``gfx1151`` GPU.
|
|
|
|
.. code-block:: bash
|
|
|
|
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx1151-7.11.0.tar.gz
|
|
mkdir install
|
|
tar -xf *.tar.gz -C install
|
|
|
|
.. selected:: gpu=9-hx-375 gpu=9-hx-370 gpu=9-365
|
|
|
|
Use the following commands to download and untar the ROCm tarball for
|
|
your ``gfx1150`` GPU.
|
|
|
|
.. code-block:: bash
|
|
|
|
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx1150-7.11.0.tar.gz
|
|
mkdir install
|
|
tar -xf *.tar.gz -C install
|
|
|
|
.. selected:: os=windows
|
|
|
|
Download the tarball and extract the contents to ``C:\TheRock\build``.
|
|
Run the following commands in your command prompt:
|
|
|
|
.. selected:: gpu=ai-r9700 gpu=ai-r9600d gpu=rx-9070-xt gpu=rx-9070-gre gpu=rx-9070 gpu=rx-9060-xt-lp gpu=rx-9060-xt gpu=rx-9060
|
|
|
|
.. code-block:: cmd
|
|
|
|
cd C:\TheRock\build
|
|
curl -o therock-dist-windows-gfx120X-all-7.11.0.tar.gz https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx120X-all-7.11.0.tar.gz
|
|
tar -xzf therock-dist-windows-gfx120X-all-7.11.0.tar.gz -C build --strip-components=1
|
|
|
|
- Download link: `therock-dist-windows-gfx120X-all-7.11.0.tar.gz
|
|
<https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx120X-all-7.11.0.tar.gz>`__
|
|
|
|
.. selected:: gpu=w7900-dual-slot gpu=w7900 gpu=w7800-48gb gpu=w7800 gpu=w7700 gpu=v710 gpu=rx-7900-xtx gpu=rx-7900-xt gpu=rx-7900-gre gpu=rx-7800-xt gpu=rx-7700-xt gpu=rx-7700
|
|
|
|
.. code-block:: cmd
|
|
|
|
cd C:\TheRock\build
|
|
curl -o therock-dist-windows-gfx110X-all-7.11.0.tar.gz https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx110X-all-7.11.0.tar.gz
|
|
tar -xzf therock-dist-windows-gfx110X-all-7.11.0.tar.gz -C build --strip-components=1
|
|
|
|
- Download link: `therock-dist-windows-gfx110X-all-7.11.0.tar.gz
|
|
<https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx110X-all-7.11.0.tar.gz>`__
|
|
|
|
.. selected:: gpu=w6800 gpu=v620
|
|
|
|
.. code-block:: cmd
|
|
|
|
cd C:\TheRock\build
|
|
curl -o therock-dist-windows-gfx103X-dgpu-7.11.0.tar.gz https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx103X-dgpu-7.11.0.tar.gz
|
|
tar -xzf therock-dist-windows-gfx103X-dgpu-7.11.0.tar.gz -C build --strip-components=1
|
|
|
|
- Download link: `therock-dist-windows-gfx103X-dgpu-7.11.0.tar.gz
|
|
<https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx103X-dgpu-7.11.0.tar.gz>`__
|
|
|
|
.. selected:: gpu=max-pro-395 gpu=max-pro-390 gpu=max-pro-385 gpu=max-pro-380 gpu=max-395 gpu=max-390 gpu=max-385
|
|
|
|
.. code-block:: cmd
|
|
|
|
cd C:\TheRock\build
|
|
curl -o therock-dist-windows-gfx1151-7.11.0.tar.gz https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx1151-7.11.0.tar.gz
|
|
tar -xzf therock-dist-windows-gfx1151-7.11.0.tar.gz -C build --strip-components=1
|
|
|
|
- Download link: `therock-dist-windows-gfx1151-7.11.0.tar.gz
|
|
<https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx1151-7.11.0.tar.gz>`__
|
|
|
|
.. selected:: gpu=9-hx-375 gpu=9-hx-370 gpu=9-365
|
|
|
|
.. code-block:: cmd
|
|
|
|
cd C:\TheRock\build
|
|
curl -o therock-dist-windows-gfx1150-7.11.0.tar.gz https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx1150-7.11.0.tar.gz
|
|
tar -xzf therock-dist-windows-gfx1150-7.11.0.tar.gz -C build --strip-components=1
|
|
|
|
- Download link: `therock-dist-windows-gfx1150-7.11.0.tar.gz
|
|
<https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx1150-7.11.0.tar.gz>`__
|