mirror of
https://github.com/ROCm/ROCm.git
synced 2026-02-12 07:25:22 -05:00
5ac64b9f6b
update ROCM_VERSION in conf 7.11 known issues added Minor change docs(RELEASE): supported OSes and hw docs(release.md): update hw support and os support js(selector-toc): remove unused code docs(index): update rocm ontology diagram add TM symbols docs(RELEASE): complete virtualization support tbl docs(toc): add rocm-examples to toc chore: bump rocm-docs-core to 1.31.3 chore: update version histor page docs(RELEASE): add oses docs(RELEASE): add virtu sup fix docs: update RELEASE.md docs(RELEASE): clean up py(selector): allow percentage widths docs(compat): update system-instinct table docs: finalize components lists docs(compat): update system-radeon-pro docs(compat): update system-radeon docs: compat docs(RELEASE): clean up docs(RELEASE): update tables docs(compat): add virtu sup and fix stuff docs(RELEASE): update AMD GPU Driver vers dcos(compat): add missing mi2xx options docs(RELEASE): update firmware for instinct docs(RELEASE): fix xref and fmt docs(rocm-ontology diagram): fix sideways tm fix oops, fix docs: remove ROCgdb docs(compat): add rhel 8.10 to mi35x docs: clean up some wording docs(install): update selector docs(install/compat): fix selector data docs: fix js: fix reconcile selections wip: install wip: install js: add URLSearchParams wip: install js: inline page-specific js docs(compat): add missing rocky linux to mi300x docs(install): windows adrenalin prereq wip: install docs(compat): virtu sup link docs: windows tar docs(compat/install): add missing gfx120x, gfx103x, and gfx110x gpus docs(RELEASE): add missing gfx120x, gfx103x, and gfx110x gpus docs(install): fix selected content docs(install): windows tar rm jira notes docs(comfyui): update docs(comfyui): update path docs: remove hipDNN chore(conf.py): exclude `**/includes/**` to build only when included docs(index): fix diagram colors Update RELEASE.md remove fn docs: remove gfx1030 cards docs: remove windows for gfx12 js: add localStorage to selector for persistence docs(RELEASE): fix gpu list in tables js(primary toc install headings): don't reload page if already on the install page docs(img): add oses to ontology diagram docs(rocgdb): add it back + document known issue docs(comfyui): update selector docs(RELEASE): fix docs(compat): fix - add rocky linux for mi300a docs(install): sles - remove --gpg-auto-import-keys py(selector): add static assets only if exists js(selector): clear URLSearchParams if page doesn't have selector docs: note GIM driver 8.7.0K for virtualization on instinct add link to gim docs docs: reorder list of components docs(install): add oem kernel prereq docs: clean up diagrams fix link docs(RELEASE): update firmware explanation docs: update chore: clean up extra files chore: linting errors docs(compat): add iGPU to ryzen cards in compat matrix docs(install): add install libatomic1 docs(install): clean up fix docs(install): add meta packages table docs(compat): remove amdgpu 7.0.3 and 6.4.2 docs(install): uninstall add meta package note blurb docs(RELEASE): apex known issue docs: update components lists in RELEASE and compat matrix docs(install): clean up meta packages sections docs(compat): update fw version for mi300x update known issues docs: remove minor version from OL and Rocky docs: fix windows whl urls docs(install): update rocminfo and amd-smi version example outputs docs(RELEASE): add known issues docs: fix linux components list docs(compat): make igpu heading consistent Add rocm-examples known issue Co-authored-by: Istvan Kiss <istvan.kiss@amd.com> docs(conf): update release date docs(install): update windows install instructions update docs(RELEASE): update known issues hipblaslt matmul known issue update known issues add hipify-clang known issue js(selector): fix syncStateToURL update amdgpu driver versions and known issues update known issues fix fix fix install urls update RELEASE.md fix update for consistency add known issue add rccl known issue update components table fix amdgpu versions update prereqs intro
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/latest/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/latest/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/latest/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/latest/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/latest/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/latest/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>`__
|