github/ROCm
1
1
Fork 0
mirror of https://github.com/ROCm/ROCm.git synced 2026-02-12 15:34:58 -05:00
Code Issues Packages Projects Releases Wiki Activity

[docs/7.11.0] Update docs for 7.11

Browse Source 
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
This commit is contained in:
Peter Park
2026-01-21 14:27:03 -05:00
parent ffa6360979
commit 5ac64b9f6b
35 changed files with 5092 additions and 1723 deletions
Download Patch File Download Diff File Expand all files Collapse all files

842
docs/install/includes/install.rst
View File

File diff suppressed because it is too large Load Diff

39
docs/install/includes/post-install.rst
View File

@@ -8,13 +8,13 @@ Post-installation
.. include:: ./includes/selector.rst
After installing the ROCm Core SDK |ROCM_VERSION| -- see :ref:`rocm-install` --
complete these post-installation steps to complete your system configuration
and validate the installation.
After installing the ROCm Core SDK |ROCM_VERSION|, complete these
post-installation steps to complete your system configuration and validate the
installation.
.. selected:: i=tar
.. selected:: os=ubuntu os=rhel os=sles
.. selected:: os=ubuntu os=debian os=rhel os=oracle-linux os=rocky-linux os=sles
:heading: Configure your environment
:heading-level: 3
@@ -84,21 +84,21 @@ and validate the installation.
Configure environment variables so that ROCm libraries and tools are
available on your Windows system.
1. Set the following environment variables using the command
prompt as an administrator:
1. **Run command prompt as an administrator** and set the following environment variables.
.. code-block:: bat
.. code-block:: cmd
setx HIP_DEVICE_LIB_PATH “C:\TheRock\build\lib\llvm\amdgcn\bitcode” /M
setx HIP_PATH “C:\TheRock\build” /M
setx HIP_PLATFORM “amd” /M
setx LLVM_PATH “C:\TheRock\build\lib\llvm” /M
2. Add the following paths into PATH environment variable using your system settings GUI.
2. Add the following paths into the PATH environment variable.
- ``C:\TheRock\build\bin``
.. code-block:: cmd
- ``C:\TheRock\build\lib\llvm\bin``
setx PATH "%PATH%;C:\TheRock\build\bin" /M
setx PATH "%PATH%;C:\TheRock\build\lib\llvm\bin" /M
3. Open a new command prompt window for the environment variables to take effect. Run ``set``
to see the list of active variables.
@@ -107,12 +107,12 @@ and validate the installation.
set
.. selected:: os=ubuntu os=rhel os=sles
.. selected:: os=ubuntu os=debian os=rhel os=oracle-linux os=rocky-linux os=sles
:heading: Verify your installation
:heading-level: 3
Use the following ROCm tools to verify that the ROCm stack is correctly
installed and that your AMD GPU is visible to the system.
Use the following ROCm tools to verify that the ROCm Core SDK is correctly
installed and that your AMD devices are visible to the system.
1. Use ``rocminfo`` to list detected AMD GPUs and confirm that the ROCm
runtimes and drivers are correctly installed and loaded.
@@ -129,7 +129,7 @@ and validate the installation.
.. code-block:: shell-session
ROCk module is loaded
ROCk module version 6.18.4 is loaded
=====================
HSA System Attributes
=====================
@@ -171,7 +171,7 @@ and validate the installation.
.. code-block:: shell-session
AMDSMI Tool: 26.1.0+cd50d9e0 | AMDSMI Library version: 26.1.0 | ROCm version: 7.10.0 | amdgpu version: 6.16.6 | amd_hsmp version: N/A
AMDSMI Tool: 26.2.1+7b886380f9 | AMDSMI Library version: 26.2.1 | ROCm version: 7.11.0 | amdgpu version: 6.18.4 | hsmp version: N/A
.. selected:: i=pip
@@ -188,8 +188,8 @@ and validate the installation.
:heading: Verify your installation
:heading-level: 3
Use the following ROCm tools to verify that the ROCm stack is correctly
installed and that your AMD GPU is visible to the system.
Use the following ROCm tools to verify that the ROCm Core SDK is correctly
installed and that your AMD devices are visible to the system.
.. selected:: i=pip
@@ -254,7 +254,7 @@ and validate the installation.
... [output truncated]
.. selected:: os=ubuntu os=rhel os=sles
.. selected:: os=ubuntu os=debian os=rhel os=oracle-linux os=rocky-linux os=sles
.. selected:: i=pip
:heading: Test your installation
@@ -270,6 +270,7 @@ and validate the installation.
rocm-sdk path --cmake
rocm-sdk path --bin
rocm-sdk path --root
rocm-sdk test
To learn more about the ``rocm-sdk`` tool and to see example expected
outputs, see `Using ROCm Python packages (TheRock)
@@ -310,7 +311,7 @@ and validate the installation.
If you need to deactivate your Python virtual environment when finished, run:
.. code-block::
.. code-block:: bash
deactivate

354
docs/install/includes/prerequisites.rst
View File

@@ -1,72 +1,100 @@
Prerequisites
=============
Before installing the ROCm Core SDK |ROCM_VERSION|, ensure your system meets
all prerequisites. This includes installing the required dependencies and
configuring permissions for GPU access. To confirm that your system is
supported, see the :doc:`Compatibility matrix
</compatibility/compatibility-matrix>`.
.. selected:: os=ubuntu os=debian os=rhel os=oracle-linux os=rocky-linux os=sles
.. selected:: os=ubuntu os=rhel os=sles
Before installing the ROCm Core SDK |ROCM_VERSION|, ensure your system meets
all prerequisites. This includes installing the required dependencies and
configuring permissions for GPU access. To confirm that your system is
supported, see the :doc:`Compatibility matrix
</compatibility/compatibility-matrix>`.
.. dropdown:: Install essential packages for Docker containers
:animate: fade-in-slide-down
:color: info
:icon: tools
:chevron: down-up
.. selected:: os=windows
Docker images often include only a minimal set of installations, so some
essential packages might be missing. When installing ROCm within a Docker
container, you might need to install additional packages for a successful
installation.
Before installing the ROCm Core SDK |ROCM_VERSION|, ensure your system meets
all prerequisites. To confirm that your system is supported, see the
:doc:`Compatibility matrix </compatibility/compatibility-matrix>`.
If applicable, run the following command to install essential packages:
.. ====================================================== DOCKER REQUIREMENTS ==
.. selected:: os=ubuntu
.. selected:: i=pip i=tar i=pkgman
.. code-block:: bash
.. selected:: os=ubuntu os=debian os=rhel os=rocky-linux os=oracle-linux os=sles
apt update
apt install sudo wget python3 libatomic1
.. dropdown:: Install essential packages for Docker containers
:animate: fade-in-slide-down
:color: info
:icon: tools
:chevron: down-up
.. selected:: os=rhel
Docker images often include only a minimal set of installations, so some
essential packages might be missing. When installing ROCm within a Docker
container, you might need to install additional packages for a successful
installation.
.. selected:: os-version=10.1 os-version=10.0 os-version=9.7 os-version=9.6
If applicable, run the following command to install essential packages:
.. selected:: os=ubuntu os=debian
.. selected:: i=pkgman
.. code-block:: bash
apt update
apt install sudo wget
.. selected:: i=pip
.. code-block:: bash
apt update
apt install sudo cmake libgfortran5
.. selected:: i=tar
.. code-block:: bash
apt update
apt install sudo wget python3
.. selected:: os=rhel os=rocky-linux os=oracle-linux
.. code-block:: bash
dnf install sudo wget libatomic
dnf install sudo wget
.. selected:: os-version=8
.. selected:: os=sles
.. code-block:: bash
.. selected:: i=pkgman
dnf install sudo wget libatomic python3
.. code-block:: bash
.. selected:: os=sles
zypper install sudo wget SUSEConnect
.. code-block:: bash
.. selected:: i=pip
zypper install sudo libatomic1 libgfortran5 wget SUSEConnect python3
.. code-block:: bash
zypper install sudo wget cmake libgfortran5
.. selected:: i=tar
.. code-block:: bash
zypper install sudo wget
.. selected:: os=windows
1. Remove any existing HIP SDK for Windows installations and other
conflicting AMD graphics software.
conflicting AMD graphics software. To uninstall the HIP SDK using the
GUI, navigate to the following screen:
2. Install the Adrenalin Driver for Windows.
* Control Panel > Programs > Uninstall a program
* For general use cases, use the Adrenalin Driver version 25.11.1. For
details and the download link, see `AMD Software: Adrenalin
Edition 25.11.1
<https://www.amd.com/en/resources/support-articles/release-notes/RN-RAD-WIN-25-11-1.html>`__.
* If you intend to run :ref:`ComfyUI workloads
<install-comfyui-windows>`, use driver version 25.20.01.17. For
details and the download link, see `AMD Software: PyTorch on Windows
Edition 7.1.1
<https://www.amd.com/en/resources/support-articles/release-notes/RN-AMDGPU-WINDOWS-PYTORCH-7-1-1.html>`__.
2. Install AMD Software: Adrenalin Edition for Windows. For details and the
download link, see `AMD Software: Adrenalin Edition 26.1.1
<https://www.amd.com/en/resources/support-articles/release-notes/RN-RAD-WIN-26-1-1.html#Downloads>`__.
3. Disable the following Windows security features as they can interfere
with ROCm functionality:
@@ -82,6 +110,27 @@ supported, see the :doc:`Compatibility matrix
* Settings > Privacy & security > Windows Security > App & browser
control > Smart App Control settings > **Off**
.. =============================================================== OEM KERNEL ==
.. selected:: fam=ryzen
.. selected:: os=ubuntu
:heading: Install the OEM kernel
:heading-level: 3
Ryzen APUs require the OEM kernel 6.14 for Ubuntu 24.04. Use the
following command to install it using ``apt``.
.. code-block:: bash
sudo apt update && sudo apt install linux-image-6.14.0-1018-oem
.. note::
Reboot your system after installing the OEM kernel.
.. ================================================ REGISTER ENTERPRISE LINUX ==
.. selected:: os=rhel
:heading: Register your Red Hat Enterprise Linux system
:heading-level: 3
@@ -97,7 +146,7 @@ supported, see the :doc:`Compatibility matrix
subscription-manager register --username <username> --password <password>
.. selected:: os-version=9.7 os-version=9.6 os-version=8
.. selected:: os-version=9.7 os-version=9.6 os-version=9.4 os-version=8.10
.. code-block:: bash
@@ -117,6 +166,8 @@ supported, see the :doc:`Compatibility matrix
sudo SUSEConnect -r <REGCODE>
.. ========================================== ADDITIONAL PACKAGE REPOSITORIES ==
.. selected:: os=rhel
:heading: Update your system
:heading-level: 3
@@ -150,7 +201,13 @@ supported, see the :doc:`Compatibility matrix
sudo dnf update --releasever=9.6 --exclude=\*release\*
.. selected:: os-version=8
.. selected:: os-version=9.4
.. code-block:: bash
sudo dnf update --releasever=9.4 --exclude=\*release\*
.. selected:: os-version=8.10
.. code-block:: bash
@@ -169,11 +226,158 @@ supported, see the :doc:`Compatibility matrix
sudo zypper update
.. selected:: i=pkgman
.. selected:: os=oracle-linux
:heading: Update your system
:heading-level: 3
Update Oracle Linux to the latest available packages.
Run the following command to update your system:
.. code-block:: bash
sudo dnf update
.. selected:: os=rhel
:heading: Add additional package repositories
:heading-level: 3
ROCm installation packages depend on packages that aren’t included in
the default package repositories. Use the following command to add the
necessary repositories.
.. selected:: os-version=10.1 os-version=10.0
.. code-block:: bash
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm
sudo rpm -ivh epel-release-latest-10.noarch.rpm
.. code-block:: bash
sudo dnf config-manager --enable codeready-builder-for-rhel-10-x86_64-rpms
.. selected:: os-version=9.7 os-version=9.6 os-version=9.4
.. code-block:: bash
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm
.. code-block:: bash
sudo dnf config-manager --enable codeready-builder-for-rhel-9-x86_64-rpms
.. selected:: os-version=8.10
.. code-block:: bash
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo rpm -ivh epel-release-latest-8.noarch.rpm
.. code-block:: bash
sudo dnf config-manager --enable codeready-builder-for-rhel-8-x86_64-rpms
.. selected:: os=oracle-linux os=rocky-linux
:heading: Add additional package repositories
:heading-level: 3
ROCm installation packages depend on packages that aren’t included in
the default package repositories. Use the following command to add the
necessary repositories.
.. selected:: os-version=10.1 os-version=10.0
.. code-block:: bash
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm
sudo rpm -ivh epel-release-latest-10.noarch.rpm
.. selected:: os-version=9.7 os-version=9.6 os-version=9.4
.. code-block:: bash
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm
.. selected:: os-version=8.10
.. code-block:: bash
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo rpm -ivh epel-release-latest-8.noarch.rpm
.. code-block:: bash
sudo crb enable
.. selected:: i=tar i=pip
.. selected:: os=sles
:heading: Add additional package repositories
:heading-level: 3
ROCm installation packages depend on packages that aren’t included in
the default package repositories. Use the following command to add the
necessary repositories.
.. selected:: os-version=16.0
.. code-block:: bash
sudo SUSEConnect -p sle-module-desktop-applications/16.0/x86_64
sudo SUSEConnect -p sle-module-development-tools/16.0/x86_64
sudo SUSEConnect -p PackageHub/16.0/x86_64
.. selected:: os-version=15.7
.. code-block:: bash
sudo SUSEConnect -p sle-module-desktop-applications/15.7/x86_64
sudo SUSEConnect -p sle-module-development-tools/15.7/x86_64
sudo SUSEConnect -p PackageHub/15.7/x86_64
.. ============================================== INSTALL ADDITIONAL PACKAGES ==
.. selected:: os=ubuntu os=debian os=rhel os=oracle-linux os=rocky-linux os=sles
.. selected:: i=pkgman i=pip i=tar
:heading: Install additional packages
:heading-level: 3
Some ROCm tools require the ``libatomic`` library to run correctly. Install
it using your distribution's package manager.
.. selected:: os=ubuntu os=debian
.. code-block:: bash
sudo apt install libatomic1
.. selected:: os=rhel os=oracle-linux os=rocky-linux
.. code-block:: bash
sudo dnf install libatomic
.. selected:: os=sles
.. code-block:: bash
sudo zypper install libatomic1
.. =========================================================== INSTALL PYTHON ==
.. selected:: i=pip
.. selected:: os=ubuntu
.. selected:: os-version=24
.. selected:: os-version=24.04
:heading: Install Python
:heading-level: 3
@@ -184,7 +388,7 @@ supported, see the :doc:`Compatibility matrix
sudo apt install python3.12 python3.12-venv
.. selected:: os-version=22
.. selected:: os-version=22.04
:heading: Install Python
:heading-level: 3
@@ -195,7 +399,20 @@ supported, see the :doc:`Compatibility matrix
sudo apt install python3.11 python3.11-venv
.. selected:: os=rhel
.. selected:: os=debian
.. selected:: os-version=13
:heading: Install Python
:heading-level: 3
Install a supported Python version. For example, to install Python
3.13, run the following command:
.. code-block:: bash
sudo apt install python3.13 python3.13-venv
.. selected:: os=rhel os=oracle-linux os=rocky-linux
.. selected:: os-version=10.1 os-version=10.0
:heading: Install Python
@@ -223,40 +440,35 @@ supported, see the :doc:`Compatibility matrix
:heading: Install Python
:heading-level: 3
Install a supported Python version. For example, to install Python 3.11,
run the following command:
.. selected:: os-version=16.0
.. code-block:: bash
Install a supported Python version. For example, to install Python 3.13,
run the following command:
sudo zypper install -y python311 python311-pip
.. code-block:: bash
sudo zypper install -y python313 python313-pip
.. selected:: os-version=15.7
Install a supported Python version. For example, to install Python 3.11,
run the following command:
.. code-block:: bash
sudo zypper install -y python311 python311-pip
.. selected:: os=windows
:heading: Install Python
:heading-level: 3
Install a supported Python version: 3.11, 3.12, or 3.13.
Install a supported Python version: 3.11, 3.12, or 3.13. See `Python
Releases for Windows <https://www.python.org/downloads/windows/>`__ for
installation details.
.. selected:: os=rhel
.. =================================================== GPU ACCESS PERMISSIONS ==
.. selected:: os-version=10.0 os-version=8
:heading: Install additional development packages
:heading-level: 3
.. code-block:: bash
sudo dnf install libatomic
.. selected:: os=sles
.. selected:: os-version=15
:heading: Install additional development packages
:heading-level: 3
.. code-block:: bash
sudo zypper install libatomic1
.. selected:: os=ubuntu os=rhel os=sles
.. selected:: os=ubuntu os=debian os=rhel os=oracle-linux os=rocky-linux os=sles
:heading: Configure permissions for GPU access
:heading-level: 3

242
docs/install/includes/selector.rst
View File

@@ -1,68 +1,227 @@
.. include:: /compatibility/includes/selector.rst
.. selected:: fam=instinct fam=radeon-pro fam=radeon
.. =========================================================== UBUNTU VERSION ==
.. selected:: os=ubuntu
.. selector:: Ubuntu version
:key: os-version
:show-when: os=ubuntu
.. selector-option:: 24.04.3
:value: 24
:show-when: fam=instinct fam=radeon-pro fam=radeon
:value: 24.04
:width: 6
.. selector-option:: 22.04.5
:value: 22
.. selected:: fam=ryzen
.. selector:: Ubuntu version
:key: os-version
:show-when: os=ubuntu
:show-when: fam=instinct fam=radeon-pro fam=radeon
:value: 22.04
:width: 6
.. selector-option:: 24.04.3
:value: 24
:show-when: fam=ryzen
:value: 24.04
:width: 12
.. selector:: RHEL version
:key: os-version
:show-when: os=rhel
.. selector-option:: 10.1
:value: 10.1
:width: 3
.. =========================================================== DEBIAN VERSION ==
.. selector-option:: 10.0
:value: 10.0
:width: 3
.. selected:: os=debian
.. selector-option:: 9.7
:value: 9.7
:width: 2
.. selector:: Debian version
:show-when: gpu=mi355x gpu=mi325x gpu=mi350x gpu=mi300x
:key: os-version
.. selector-option:: 9.6
:value: 9.6
:width: 2
.. selector-option:: 13
:width: 12
.. selector-option:: 8.10
:value: 8
:width: 2
.. selector:: SLES version
:key: os-version
:show-when: os=sles
.. ============================================================= RHEL VERSION ==
.. selector-option:: 15.7
:value: 15
:width: 12
.. selected:: os=rhel
.. selector:: Windows version
:key: os-version
:show-when: os=windows
.. selector:: RHEL version
:key: os-version
:show-when: fam=instinct fam=radeon-pro fam=radeon
.. selector-option:: 11 25H2
:value: 11-25h2
:width: 12
.. selector-option:: 10.1
:show-when: gpu=mi355x gpu=mi350x gpu=mi300x gpu=mi300a gpu=mi250x gpu=mi250 gpu=mi210
:width: 2
.. selector-option:: 10.0
:show-when: gpu=mi355x gpu=mi350x gpu=mi300x gpu=mi300a gpu=mi250x gpu=mi250 gpu=mi210
:width: 2
.. selector-option:: 9.7
:show-when: gpu=mi355x gpu=mi350x gpu=mi300x gpu=mi300a gpu=mi250x gpu=mi250 gpu=mi210
:width: 2
.. selector-option:: 9.6
:show-when: gpu=mi355x gpu=mi350x gpu=mi300x gpu=mi300a gpu=mi250x gpu=mi250 gpu=mi210
:width: 2
.. selector-option:: 9.4
:show-when: gpu=mi355x gpu=mi350x gpu=mi300x gpu=mi300a gpu=mi250x gpu=mi250 gpu=mi210
:width: 2
.. selector-option:: 8.10
:show-when: gpu=mi355x gpu=mi350x gpu=mi300x gpu=mi300a gpu=mi250x gpu=mi250 gpu=mi210
:width: 2
.. selector-option:: 10.1
:show-when: gpu=mi325x
:width: 20%
.. selector-option:: 10.0
:show-when: gpu=mi325x
:width: 20%
.. selector-option:: 9.7
:show-when: gpu=mi325x
:width: 20%
.. selector-option:: 9.6
:show-when: gpu=mi325x
:width: 20%
.. selector-option:: 9.4
:show-when: gpu=mi325x
:width: 20%
.. selector-option:: 10.1
:show-when: fam=radeon-pro fam=radeon
:width: 6
.. selector-option:: 9.7
:show-when: fam=radeon-pro fam=radeon
:width: 6
.. ===================================================== ORACLE LINUX VERSION ==
.. selected:: os=oracle-linux
.. selector:: Oracle Linux version
:show-when: gpu=mi355x gpu=mi350x gpu=mi325x gpu=mi300x
:key: os-version
.. selector-option:: 10
:show-when: gpu=mi355x gpu=mi350x gpu=mi325x
:width: 6
:value: 10.1
.. selector-option:: 9
:show-when: gpu=mi355x gpu=mi350x gpu=mi325x
:width: 6
:value: 9.6
.. selector-option:: 10
:show-when: gpu=mi300x
:width: 4
:value: 10.1
.. selector-option:: 9
:show-when: gpu=mi300x
:width: 4
:value: 9.6
.. selector-option:: 8
:show-when: gpu=mi300x
:width: 4
:value: 8.10
.. ====================================================== ROCKY LINUX VERSION ==
.. selected:: os=rocky-linux
.. selector:: Rocky Linux version
:show-when: gpu=mi300x gpu=mi300a
:key: os-version
.. selector-option:: 9
:width: 12
:value: 9.7
.. ============================================================= SLES VERSION ==
.. selected:: os=sles
.. selector:: SLES version
:show-when: fam=instinct
:key: os-version
.. selector-option:: 16.0
:width: 6
.. selector-option:: 15.7
:width: 6
.. ========================================================== WINDOWS VERSION ==
.. selected:: os=windows
.. selector:: Windows version
:key: os-version
.. selector-option:: 11 25H2
:width: 12
.. ====================================================== INSTALLATION METHOD ==
.. selector:: Installation method
:show-when: os=ubuntu os=debian
:key: i
.. selector-option:: apt
:value: pkgman
:width: 4
.. selector-option:: pip
:value: pip
:width: 4
.. selector-option:: Tarball
:value: tar
:width: 4
.. selector:: Installation method
:show-when: os=rhel os=oracle-linux os=rocky-linux
:key: i
.. selector-option:: dnf
:value: pkgman
:width: 4
.. selector-option:: pip
:value: pip
:width: 4
.. selector-option:: Tarball
:value: tar
:width: 4
.. selector:: Installation method
:show-when: os=sles
:key: i
.. selector-option:: zypper
:value: pkgman
:width: 4
.. selector-option:: pip
:value: pip
:width: 4
.. selector-option:: Tarball
:value: tar
:width: 4
.. selector:: Installation method
:show-when: os=windows
:key: i
.. selector-option:: pip
@@ -70,4 +229,3 @@
.. selector-option:: Tarball
:value: tar

175
docs/install/includes/uninstall.rst
View File

@@ -8,13 +8,153 @@ Uninstalling
.. include:: ./includes/selector.rst
.. ========================================================== PACKAGE MANAGER ==
.. selected:: i=pkgman
:heading: Uninstall ROCm packages
:heading-level: 3
1. Use your package manager to remove :ref:`ROCm meta packages <rocm-install-meta-packages>` installed on your system.
.. selected:: os=ubuntu os=debian
.. selected:: gpu=mi355x gpu=mi350x
.. code-block:: bash
sudo apt autoremove amdrocm7.11-gfx950
.. selected:: gpu=mi325x gpu=mi300x gpu=mi300a
.. code-block:: bash
sudo apt autoremove amdrocm7.11-gfx94x
.. selected:: gpu=mi250x gpu=mi250 gpu=mi210
.. code-block:: bash
sudo apt autoremove 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 autoremove amdrocm7.11-gfx120x
.. selected:: gpu=w7900-dual-slot gpu=w7900 gpu=w7800-48gb gpu=w7800 gpu=w7700 gpu=v710 gpu=v620
.. code-block:: bash
sudo apt autoremove amdrocm7.11-gfx110x
.. selected:: gpu=w6800 gpu=v620
.. code-block:: bash
sudo apt autoremove 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
.. selected:: gpu=mi355x gpu=mi350x
.. code-block:: bash
sudo dnf remove amdrocm7.11-gfx950
.. selected:: gpu=mi325x gpu=mi300x gpu=mi300a
.. code-block:: bash
sudo dnf remove amdrocm7.11-gfx94x
.. selected:: gpu=mi250x gpu=mi250 gpu=mi210
.. code-block:: bash
sudo dnf remove 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 remove amdrocm7.11-gfx120x
.. selected:: gpu=w7900-dual-slot gpu=w7900 gpu=w7800-48gb gpu=w7800 gpu=w7700 gpu=v710 gpu=v620
.. code-block:: bash
sudo dnf remove amdrocm7.11-gfx110x
.. selected:: gpu=w6800 gpu=v620
.. code-block:: bash
sudo dnf remove amdrocm7.11-gfx103x
.. selected:: os=sles
.. code-block:: bash
sudo zypper remove amdrocm*
2. Remove ROCm repositories.
.. selected:: os=ubuntu os=debian
.. code-block:: bash
# Remove ROCm repositories
sudo rm /etc/apt/sources.list.d/rocm.list
# Clear the cache and clean the system
sudo rm -rf /var/cache/apt/*
sudo apt clean all
sudo apt update
.. selected:: os=rhel os=oracle-linux os=rocky-linux
.. code-block:: bash
# Remove ROCm repositories
sudo rm /etc/yum.repos.d/rocm.repo*
# Clear the cache and clean the system
sudo rm -rf /var/cache/dnf
sudo dnf clean all
.. selected:: os=sles
.. code-block:: bash
# Remove ROCm repositories
sudo zypper removerepo "rocm"
# Clear the cache and clean the system
sudo zypper clean --all
sudo zypper refresh
.. ====================================================================== PIP ==
.. selected:: i=pip
:heading: Remove your Python virtual environment
:heading-level: 3
1. Clear the pip cache.
.. selected:: os=ubuntu os=rhel os=sles
.. selected:: os=ubuntu os=debian os=rhel os=oracle-linux os=rocky-linux os=sles
.. code-block:: bash
@@ -28,7 +168,7 @@ Uninstalling
2. Remove your local Python virtual environment.
.. selected:: os=ubuntu os=rhel os=sles
.. selected:: os=ubuntu os=debian os=rhel os=oracle-linux os=rocky-linux os=sles
.. code-block:: bash
@@ -40,13 +180,13 @@ Uninstalling
rmdir /s /q .venv
.. selected:: os=windows
.. ================================================================== TARBALL ==
.. selected:: i=tar
:heading: Remove your installation directory
:heading-level: 3
.. selected:: os=ubuntu os=rhel os=sles
.. selected:: os=ubuntu os=debian os=rhel os=oracle-linux os=rocky-linux os=sles
1. To uninstall ROCm, remove your installation directory.
@@ -71,8 +211,11 @@ Uninstalling
.. selected:: os=windows
1. Delete your ``C:\TheRock\build`` installation directory and its
contents.
1. To uninstall ROCm, remove your installation directory.
.. code-block:: cmd
rmdir /s /q C:\TheRock
.. important::
@@ -81,22 +224,26 @@ Uninstalling
:ref:`installing ROCm <rocm-install>`, adjust this step
accordingly.
2. Delete the environment variables. For example, using PowerShell as an administrator:
2. **Run command prompt as an administrator** and delete the following environment variables.
.. code-block:: powershell
.. code-block:: cmd
[Environment]::SetEnvironmentVariable("HIP_PATH", $null, "Machine")
[Environment]::SetEnvironmentVariable("HIP_DEVICE_LIB_PATH", $null, "Machine")
[Environment]::SetEnvironmentVariable("HIP_PLATFORM", $null, "Machine")
[Environment]::SetEnvironmentVariable("LLVM_PATH", $null, "Machine")
setx HIP_DEVICE_LIB_PATH "" /M
setx HIP_PATH "" /M
setx HIP_PLATFORM "" /M
setx LLVM_PATH "" /M
Remove the following paths from your PATH environment variable using your system settings GUI.
Navigate to the following screen:
* Control Panel > System and Security > Edit environment variables
Edit the PATH variable and delete the following paths:
* ``C:\TheRock\build\bin``
* ``C:\TheRock\build\lib\llvm\bin``
3. If you want to uninstall the Adrenalin driver, see `Uninstall AMD
Software
3. To uninstall the Adrenalin Driver, see `Uninstall AMD Software
<https://www.amd.com/en/resources/support-articles/faqs/RSX2-UNINSTALL.html>`__.

13
docs/install/rocm.rst
View File

@@ -1,6 +1,6 @@
.. meta::
:description: Learn how to install AMD ROCm 7.10.0 for supported Instinct GPUs and Ryzen AI APUs on Ubuntu, RHEL, and Windows. This step-by-step guide covers prerequisites, driver setup, installation methods (pip and tarball), and troubleshooting.
:keywords: AMD ROCm 7.10.0, install ROCm, Instinct GPU, Ryzen APU, Ubuntu, RHEL, Windows, pip install ROCm, ROCm wheel, ROCm tarball, ROCm GPU driver, ROCm setup, ROCm uninstall, ROCm troubleshooting
:description: Learn how to install AMD ROCm 7.11.0 for supported Instinct GPUs and Ryzen AI APUs on Ubuntu, RHEL, and Windows. This step-by-step guide covers prerequisites, driver setup, installation methods (pip and tarball), and troubleshooting.
:keywords: AMD ROCm 7.11.0, install ROCm, Instinct GPU, Ryzen APU, Ubuntu, RHEL, Windows, pip install ROCm, ROCm wheel, ROCm tarball, ROCm GPU driver, ROCm setup, ROCm uninstall, ROCm troubleshooting
*******************************
Install AMD ROCm |ROCM_VERSION|
@@ -52,4 +52,11 @@ in ROCm |ROCM_VERSION|, see the :doc:`Release notes </about/release-notes>`.
.. raw:: html
<script src="../_static/next-button-install-page.js"></script>
<script>
document.addEventListener("DOMContentLoaded", () => {
const nextLink = document.querySelector("footer.prev-next-footer a.right-next");
const nextTitle = nextLink.querySelector(".prev-next-title");
nextTitle.textContent = "Build the ROCm Core SDK from source";
nextLink.href = "./build-from-source.html";
});
</script>