+
+
+
+
+
+
+ Enterprise applications
+
+
+
+
+
+
+
+
+
+
+ Personal assistant
+
+
+
+
+
+
+
+
+
+
+
+ AMD ROCm™ software ecosystem
+
+
+
+
+
+
+ AMD enterprise AI
+
+
+
+
+
+
+ AMD Resource Manager
+
+
+
+
+ AMD Solution Blueprints
+
+
+
+
+ AMD Developer Console
+
+
+
+
+ AMD Inference Microservices
+
+
+
+
+
+
+
+
+
+
+ Cluster operations
+
+
+
+
+
+
+
+
+ Model serving runtimes:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Math and compute libraries
+
+
+
+
+ Communication libraries
+
+
+
+
+ Support libraries
+
+
+
+
+
+
+ Runtimes and compilers
+
+
+
+
+ Profiling and debugging tools
+
+
+
+
+ Control and monitoring tools
+
+
+
+
+
+
+
+ Systems and infrastructure
+
+
+
+
+
+
+ Kubernetes:
+
+ - GPU Operator
+ - Device Plugin
+ - Container Toolkit
+ - Device Metrics Exporter
+ - Device Plugin
+
+
+
+
+
+
+
+ AMD GPU Driver and runtime firmware
+
+
+
+
+ AMD Virtualization Driver
+
+
+
+
+ AMD Instinct™ Fabric
+ Manager
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Baseboard and GPU firmware (platform-optimized firmware)
+
+
+
+
+
+
+
+
+
+
+
+ AMD GPUs and APUs
+
+
+
+
+
+
{label}
""".strip()
@@ -203,7 +225,7 @@ class SelectorOptionDirective(SphinxDirective):
"show-when": directives.unchanged,
"disable-when": directives.unchanged,
"default": directives.flag,
- "width": directives.nonnegative_int,
+ "width": directives.unchanged,
"icon": directives.unchanged,
}
has_content = True
@@ -216,14 +238,35 @@ class SelectorOptionDirective(SphinxDirective):
node["show-when"] = self.options.get("show-when", "")
node["disable-when"] = self.options.get("disable-when", "")
node["default"] = self.options.get("default", False) is not False
- node["width"] = self.options.get("width", 6)
- node["icon"] = self.options.get("icon")
- # Content replaces label if provided
- # if self.content:
- # self.state.nested_parse(self.content, self.content_offset, node)
- # else:
- # node += nodes.Text(label)
+ # Parse width - supports bootstrap (1-12) or percentage (like "25%")
+ width_value = self.options.get("width", "6")
+ if isinstance(width_value, str) and width_value.endswith("%"):
+ try:
+ pct = float(width_value[:-1])
+ if pct <= 0 or pct > 100:
+ raise ValueError("must be between 0 and 100")
+ node["width"] = width_value
+ except ValueError as e:
+ logger.warning(
+ f"Invalid percentage width '{width_value}' ({e}), using default",
+ location=(self.env.docname, self.lineno),
+ )
+ node["width"] = 6
+ else:
+ try:
+ col_num = int(width_value)
+ if col_num < 1 or col_num > 12:
+ raise ValueError("must be between 1 and 12")
+ node["width"] = col_num
+ except ValueError as e:
+ logger.warning(
+ f"Invalid width '{width_value}' ({e}), using default",
+ location=(self.env.docname, self.lineno),
+ )
+ node["width"] = 6
+
+ node["icon"] = self.options.get("icon")
parent = getattr(self.state, "parent", None)
if not parent or not any(isinstance(p, SelectorGroup) for p in parent.traverse(include_self=True)):
@@ -346,9 +389,4 @@ def setup(app):
app.add_directive("selected-content", SelectedContentDirective)
app.add_directive("selected", SelectedContentDirective)
- static_assets_dir = Path(__file__).parent / "static" / "selector"
- app.config.html_static_path.append(str(static_assets_dir))
- app.add_css_file("selector.css")
- app.add_js_file("selector.js", type="module", defer="defer")
-
- return {"version": "1.1", "parallel_read_safe": True}
+ return {"version": "1.2", "parallel_read_safe": True}
diff --git a/docs/extension/rocm_docs_custom/static/selector/selector-toc.js b/docs/extension/rocm_docs_custom/static/selector/selector-toc.js
index ae3b74cc0..dc0ae4dcc 100644
--- a/docs/extension/rocm_docs_custom/static/selector/selector-toc.js
+++ b/docs/extension/rocm_docs_custom/static/selector/selector-toc.js
@@ -7,8 +7,6 @@ const HEADING_QUERY = ".rocm-docs-selected-content h1,h2,h3,h4,h5,h6";
const TOC_ITEM_CLASS = "rocm-docs-selector-toc2-item";
const EMPTY_ITEM_CLASS = "empty";
-let optionsTocInitialized = false;
-
function isVisible(el) {
return !!(el && el.offsetParent !== null);
}
@@ -31,59 +29,6 @@ function getUniqueGroups(groups) {
});
}
-function initTOC2OptionsList() {
- const tocOptionsList = document.querySelector(TOC2_OPTIONS_LIST_QUERY);
- if (!tocOptionsList) return;
-
- tocOptionsList.innerHTML = "";
-
- let groups = Array.from(document.querySelectorAll(GROUP_QUERY)).filter(isVisible);
- groups = getUniqueGroups(groups);
-
- if (groups.length === 0) {
- const li = document.createElement("li");
- li.className = `nav-item toc-entry toc-h3 ${TOC_ITEM_CLASS} ${EMPTY_ITEM_CLASS}`;
- const span = document.createElement("span");
- span.textContent = "(no visible selectors)";
- li.appendChild(span);
- tocOptionsList.appendChild(li);
- optionsTocInitialized = true;
- return;
- }
-
- groups.forEach((group) => {
- const headingSpan = group.querySelector(
- ".rocm-docs-selector-group-heading-text"
- );
- const headingText = headingSpan
- ? headingSpan.textContent.trim()
- : "(Unnamed Selector)";
-
- const li = document.createElement("li");
- li.className = `nav-item toc-entry toc-h3 ${TOC_ITEM_CLASS}`;
- li.dataset.groupId = group.id || "";
-
- const link = document.createElement("a");
- link.className = "nav-link";
- link.href = group.id ? `#${group.id}` : "#";
- link.dataset.headingText = headingText;
-
- const selectedOption = group.querySelector(`.${SELECTED_CLASS}`);
- let optionText = "(none selected)";
- if (selectedOption) {
- const clone = selectedOption.cloneNode(true);
- clone.querySelectorAll("i, svg").forEach((el) => el.remove());
- optionText = clone.innerHTML.trim();
- }
-
- link.innerHTML = `
${headingText}: ${optionText}`;
- li.appendChild(link);
- tocOptionsList.appendChild(li);
- });
-
- optionsTocInitialized = true;
-}
-
export function updateTOC2OptionsList() {
const tocOptionsList = document.querySelector(TOC2_OPTIONS_LIST_QUERY);
if (!tocOptionsList) return;
diff --git a/docs/extension/rocm_docs_custom/static/selector/selector.js b/docs/extension/rocm_docs_custom/static/selector/selector.js
index 6b0fee9c8..42ec03c9e 100644
--- a/docs/extension/rocm_docs_custom/static/selector/selector.js
+++ b/docs/extension/rocm_docs_custom/static/selector/selector.js
@@ -13,6 +13,8 @@ const DISABLED_CLASS = "rocm-docs-disabled";
const HIDDEN_CLASS = "rocm-docs-hidden";
const SELECTED_CLASS = "rocm-docs-selected";
+const STORAGE_KEY = "rocm-docs-selector-state";
+
// Toggle helpers -------------------------------------------------------------
const isDefaultOption = (elem) => elem.classList.contains(DEFAULT_OPTION_CLASS);
@@ -49,6 +51,62 @@ const deselect = (elem) => {
elem.setAttribute("aria-checked", "false");
};
+// URL synchronization --------------------------------------------------------
+
+function syncStateToURL() {
+ const params = new URLSearchParams();
+
+ for (const [key, value] of Object.entries(state)) {
+ params.set(key, value);
+ }
+
+ const newURL = params.toString()
+ ? `${window.location.pathname}?${params.toString()}${window.location.hash}`
+ : `${window.location.pathname}${window.location.hash}`;
+
+ window.history.replaceState({}, "", newURL);
+ logDebug("URL updated:", newURL);
+}
+
+function getStateFromURL() {
+ const params = new URLSearchParams(window.location.search);
+ const urlState = {};
+
+ for (const [key, value] of params) {
+ urlState[key] = value;
+ }
+
+ return urlState;
+}
+
+// localStorage synchronization -----------------------------------------------
+
+function syncStateToLocalStorage() {
+ try {
+ localStorage.setItem(STORAGE_KEY, JSON.stringify(state));
+ logDebug("localStorage updated:", state);
+ } catch (err) {
+ console.warn("[ROCmDocsSelector] Failed to save to localStorage:", err);
+ }
+}
+
+function getStateFromLocalStorage() {
+ try {
+ const stored = localStorage.getItem(STORAGE_KEY);
+ if (!stored) return {};
+
+ const parsed = JSON.parse(stored);
+ logDebug("localStorage loaded:", parsed);
+ return parsed;
+ } catch (err) {
+ console.warn(
+ "[ROCmDocsSelector] Failed to read from localStorage:",
+ err,
+ );
+ return {};
+ }
+}
+
// Global selector state ------------------------------------------------------
const state = {};
@@ -60,6 +118,8 @@ function getState() {
function setState(updates) {
Object.assign(state, updates);
logDebug("State updated:", state);
+ syncStateToURL();
+ syncStateToLocalStorage();
}
// Condition handling ---------------------------------------------------------
@@ -119,8 +179,7 @@ function shouldBeDisabled(elem) {
const conditions = parseConditions("disable-when", raw);
if (!conditions) {
console.warn(
- "[ROCmDocsSelector] Invalid 'show-when' conditions; " +
- "hiding affected element.",
+ "[ROCmDocsSelector] Invalid 'disable-when' conditions; not disabling affected element.",
);
return false;
}
@@ -181,7 +240,7 @@ function handleOptionKeydown(e) {
}
}
-// Visibility / enablement update --------------------------------------------
+// Visibility / enablement update ---------------------------------------------
// Ensure each selector group always has a valid selected option.
// If the current selection becomes disabled/hidden due to another selector's
@@ -191,8 +250,13 @@ function reconcileGroupSelections() {
const updates = {};
document.querySelectorAll(GROUP_QUERY).forEach((group) => {
- // Skip groups that are themselves hidden
- if (group.classList.contains(HIDDEN_CLASS)) return;
+ // Skip groups that are hidden OR inside a hidden parent
+ if (
+ group.classList.contains(HIDDEN_CLASS) ||
+ group.closest(`.${HIDDEN_CLASS}`)
+ ) {
+ return;
+ }
const options = Array.from(group.querySelectorAll(OPTION_QUERY));
if (!options.length) return;
@@ -229,10 +293,27 @@ function reconcileGroupSelections() {
return;
}
- // Need a new selection: prefer a default option, otherwise the first
- // enabled+visible option in DOM order.
- const replacement = enabledVisible.find(isDefaultOption) ||
- enabledVisible[0];
+ // Need a new selection: prioritize current state value
+ let replacement;
+
+ // 1. Try to match the current global state value (if exists)
+ const stateValue = currentState[groupKey];
+ if (stateValue) {
+ replacement = enabledVisible.find(
+ (opt) => opt.dataset.selectorValue === stateValue,
+ );
+ }
+
+ // 2. If no match, prefer a default option
+ if (!replacement) {
+ replacement = enabledVisible.find(isDefaultOption);
+ }
+
+ // 3. Otherwise use the first enabled+visible option
+ if (!replacement) {
+ replacement = enabledVisible[0];
+ }
+
if (!replacement) return;
options.forEach(deselect);
@@ -303,7 +384,17 @@ function updateVisibility() {
domReady(() => {
const selectorOptions = document.querySelectorAll(OPTION_QUERY);
- const initialState = {};
+ if (!selectorOptions?.length) {
+ // Clear URLSearchParams if page does not have selector
+ const url = new URL(window.location);
+ url.search = "";
+ window.history.replaceState({}, "", url);
+ return;
+ }
+
+ const defaultState = {};
+ const localStorageState = getStateFromLocalStorage();
+ const urlState = getStateFromURL();
// Attach listeners and gather defaults
selectorOptions.forEach((option) => {
@@ -311,14 +402,35 @@ domReady(() => {
option.addEventListener("keydown", handleOptionKeydown);
if (isDefaultOption(option)) {
- select(option);
const { selectorKey: key, selectorValue: value } = option.dataset;
- if (key && value && initialState[key] === undefined) {
- initialState[key] = value;
+ if (key && value && defaultState[key] === undefined) {
+ defaultState[key] = value;
}
}
});
+ // Merge with priority: URL > localStorage > defaults
+ const initialState = {
+ ...defaultState,
+ ...localStorageState,
+ ...urlState,
+ };
+
+ // Apply initial selections from merged state
+ for (const [key, value] of Object.entries(initialState)) {
+ const allOptions = document.querySelectorAll(
+ `${OPTION_QUERY}[data-selector-key="${key}"]`,
+ );
+
+ allOptions.forEach((opt) => {
+ if (opt.dataset.selectorValue === value) {
+ select(opt);
+ } else {
+ deselect(opt);
+ }
+ });
+ }
+
setState(initialState);
updateVisibility();
diff --git a/docs/extension/rocm_docs_custom/static/table.css b/docs/extension/rocm_docs_custom/static/table.css
index 0b0b6ec23..f0c692ce1 100644
--- a/docs/extension/rocm_docs_custom/static/table.css
+++ b/docs/extension/rocm_docs_custom/static/table.css
@@ -29,7 +29,12 @@ html[data-theme="dark"] {
background-color: var(--rocm-docs-table-head-bg-color);
border: 2px solid var(--rocm-docs-table-border-color);
}
+
.rocm-docs-table td {
background-color: var(--rocm-docs-table-bg-color);
border: 2px solid var(--rocm-docs-table-border-color) !important;
}
+
+.rocm-docs-table p:not(:last-child) {
+ margin-bottom: 0.3rem;
+}
diff --git a/docs/index.rst b/docs/index.rst
index f03cb3653..2ba74063e 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -36,13 +36,11 @@ frameworks such as PyTorch.
* **Comprehensive** -- End‑to‑end toolchain from compilers to libraries
* **Performance‑focused** -- Tuned for AMD Instinct™, AMD Radeon™, and AMD Ryzen™ devices
-.. image:: data/rocm-ontology.png
- :align: center
- :alt: ROCm software ecosystem and components illustration
- :width: 1000
+.. raw:: html
+ :file: data/rocm-ontology.html
ROCm supports AMD GPU architectures spanning data center, workstation, and APU
-categories. TheRock enables a unified ROCm user‑space experience across
+product lines. TheRock enables a unified ROCm user‑space experience across
devices.
* **AMD Instinct GPUs** -- Purpose‑built for large‑scale compute, AI training, and HPC workloads.
@@ -74,10 +72,8 @@ The ROCm Core SDK provides the foundational components that power the ROCm
ecosystem — runtimes, compilers, math libraries, and system utilities for GPGPU
computing.
-.. image:: data/rocm-sdk-arch.png
- :align: center
- :alt: ROCm Core SDK internal architecture illustration
- :width: 1000
+.. raw:: html
+ :file: data/rocm-sdk-arch.html
The TheRock infrastructure keeps these components modular, consistent, and easy
to integrate across configurations.
diff --git a/docs/install/includes/install.rst b/docs/install/includes/install.rst
index 3a8cc4e78..de447c1a1 100644
--- a/docs/install/includes/install.rst
+++ b/docs/install/includes/install.rst
@@ -19,58 +19,610 @@ see the :doc:`Compatibility matrix `.
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 `.
.. selected:: os=ubuntu
- :heading: Install kernel driver
- :heading-level: 3
-
- For information about AMD GPU Driver (amdgpu) compatibility, see the
- :doc:`Compatibility matrix `.
For instructions on installing the AMD GPU Driver (amdgpu), see `Ubuntu native
installation
`__
in the AMD Instinct Data Center GPU Documentation.
- .. selected:: os=rhel
- :heading: Install kernel driver
- :heading-level: 3
+ .. selected:: os=debian
- For information about AMD GPU Driver (amdgpu) compatibility, see the
- :doc:`Compatibility matrix `.
+ For instructions on installing the AMD GPU Driver (amdgpu), see `Debian native
+ installation
+ `__
+ in the AMD Instinct Data Center GPU Documentation.
+
+ .. selected:: os=rhel
For instructions on installing the AMD GPU Driver (amdgpu), see `RHEL native
installation
`__
in the AMD Instinct Data Center GPU Documentation.
- .. selected:: os=sles
- :heading: Install kernel driver
- :heading-level: 3
+ .. selected:: os=oracle-linux
- For information about AMD GPU Driver (amdgpu) compatibility, see the
- :doc:`Compatibility matrix `.
-
- For instructions on installing the AMD GPU Driver (amdgpu), see `SLES native
+ For instructions on installing the AMD GPU Driver (amdgpu), see `Oracle Linux native
installation
+ `__
+ 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
+ `__
+ in the AMD Instinct Data Center GPU Documentation.
+
+ .. selected:: os=sles
+
+ For instructions on installing the AMD GPU Driver (amdgpu), see `SLES
+ native installation
`__
in the AMD Instinct Data Center GPU Documentation.
.. selected:: fam=ryzen
- .. selected:: os=ubuntu os=rhel os=sles
+ .. 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 ROCm
-------------
+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 <` 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 ` 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 ` 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
@@ -80,7 +632,7 @@ Use the following instructions to install the ROCm Core SDK on your system.
.. selected:: os=ubuntu
- .. selected:: os-version=24
+ .. selected:: os-version=24.04
For example, to create and activate a Python 3.12 virtual environment,
run the following command:
@@ -90,7 +642,7 @@ Use the following instructions to install the ROCm Core SDK on your system.
python3.12 -m venv .venv
source .venv/bin/activate
- .. selected:: os-version=22
+ .. selected:: os-version=22.04
For example, to create and activate a Python 3.11 virtual environment,
run the following command:
@@ -100,7 +652,29 @@ Use the following instructions to install the ROCm Core SDK on your system.
python3.11 -m venv .venv
source .venv/bin/activate
- .. selected:: os=rhel
+ .. 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
@@ -122,7 +696,7 @@ Use the following instructions to install the ROCm Core SDK on your system.
python3.11 -m venv .venv
source .venv/bin/activate
- .. selected:: os-version=8
+ .. selected:: os-version=8.10
For example, to create and activate a Python 3.11 virtual environment,
run the following command:
@@ -134,13 +708,25 @@ Use the following instructions to install the ROCm Core SDK on your system.
.. selected:: os=sles
- For example, to create and activate a Python 3.11 virtual environment,
- run the following command:
+ .. selected:: os-version=16.0
- .. code-block:: bash
+ For example, to create and activate a Python 3.13 virtual environment,
+ run the following command:
- python3.11 -m venv .venv
- source .venv/bin/activate
+ .. 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
@@ -149,14 +735,14 @@ Use the following instructions to install the ROCm Core SDK on your system.
.. code-block:: bat
- python3.12 -m venv .venv
+ py -3.12 -m venv .venv
.venv\Scripts\activate
.. selected:: i=pip
:heading: Install ROCm wheel packages
:heading-level: 4
- .. selected:: gfx=950
+ .. selected:: gpu=mi355x gpu=mi350x
Use pip to install the ROCm Core SDK libraries and development tools for
your ``gfx950`` GPU.
@@ -167,7 +753,7 @@ Use the following instructions to install the ROCm Core SDK on your system.
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx950-dcgpu/ "rocm[libraries,devel]"
- .. selected:: gfx=942
+ .. selected:: gpu=mi325x gpu=mi300x gpu=mi300a
Use pip to install the ROCm Core SDK libraries and development tools for
your ``gfx942`` device.
@@ -178,7 +764,7 @@ Use the following instructions to install the ROCm Core SDK on your system.
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx94X-dcgpu/ "rocm[libraries,devel]"
- .. selected:: gfx=90a
+ .. selected:: gpu=mi250x gpu=mi250 gpu=mi210
Use pip to install the ROCm Core SDK libraries and development tools for
your ``gfx90a`` GPU.
@@ -189,7 +775,29 @@ Use the following instructions to install the ROCm Core SDK on your system.
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx90X-dcgpu/ "rocm[libraries,devel]"
- .. selected:: gfx=1100
+ .. 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.
@@ -198,9 +806,9 @@ Use the following instructions to install the ROCm Core SDK on your system.
.. code-block:: bash
- python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx110X-dgpu/ "rocm[libraries,devel]"
+ python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx110X-all/ "rocm[libraries,devel]"
- .. selected:: gfx=1101
+ .. 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.
@@ -209,23 +817,23 @@ Use the following instructions to install the ROCm Core SDK on your system.
.. code-block:: bash
- python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx110X-dgpu/ "rocm[libraries,devel]"
+ python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx110X-all/ "rocm[libraries,devel]"
- .. selected:: gfx=1150
+ .. selected:: gpu=w6800 gpu=v620
Use pip to install the ROCm Core SDK libraries and development tools for
- your ``gfx1150`` GPU.
+ your ``gfx1030`` GPU.
Run the following command:
.. code-block:: bash
- python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1150/ "rocm[libraries,devel]"
+ python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx103X-dgpu/ "rocm[libraries,devel]"
- .. selected:: gfx=1151
+ .. 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`` GPU.
+ your ``gfx1151`` Ryzen APU.
Run the following command:
@@ -233,11 +841,24 @@ Use the following instructions to install the ROCm Core SDK on your system.
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=rhel os=sles
+ .. 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:
@@ -255,7 +876,12 @@ Use the following instructions to install the ROCm Core SDK on your system.
.. selected:: os=windows
- Create the installation directory in ``C:\TheRock\build``.
+ 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::
@@ -267,129 +893,149 @@ Use the following instructions to install the ROCm Core SDK on your system.
:heading: Download and unpack the tarball
:heading-level: 4
- .. selected:: os=ubuntu os=rhel os=sles
+ .. selected:: os=ubuntu os=debian os=rhel os=oracle-linux os=rocky-linux os=sles
- .. selected:: gfx=950
+ .. selected:: gpu=mi355x gpu=mi350x
Use the following commands to download and untar the ROCm tarball for
your ``gfx950`` GPU.
- Run the following command:
-
.. code-block:: bash
- wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx950-dcgpu-7.10.0.tar.gz
+ 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:: gfx=942
+ .. selected:: gpu=mi325x gpu=mi300x gpu=mi300a
Use the following commands to download and untar the ROCm tarball for
your ``gfx942`` GPU.
- Run the following command:
-
.. code-block:: bash
- wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx94X-dcgpu-7.10.0.tar.gz
+ 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:: gfx=90a
+ .. selected:: gpu=mi250x gpu=mi250 gpu=mi210
Use the following commands to download and untar the ROCm tarball for
your ``gfx90a`` GPU.
- Run the following command:
-
.. code-block:: bash
- wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx90X-dcgpu-7.10.0.tar.gz
+ 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:: gfx=1100
+ .. 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 for
- your ``gfx1100`` GPU.
-
- Run the following command:
+ 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-dgpu-7.10.0.tar.gz
+ 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:: gfx=1101
+ .. 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 for
- your ``gfx1101`` GPU.
-
- Run the following command:
+ 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-dgpu-7.10.0.tar.gz
+ 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:: gfx=1150
+ .. selected:: gpu=w6800 gpu=v620
- Use the following commands to download and untar the ROCm tarball for
- your ``gfx1150`` GPU.
-
- Run the following command:
+ Use the following commands to download and untar the ROCm tarball.
.. code-block:: bash
- wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx1150-7.10.0.tar.gz
+ 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:: gfx=1151
+ .. 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.
- Run the following command:
+ .. 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-gfx1151-7.10.0.tar.gz
+ 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
- .. selected:: gfx=1100
+ Download the tarball and extract the contents to ``C:\TheRock\build``.
+ Run the following commands in your command prompt:
- Download the tarball for your ``gfx1100`` GPU and extract the contents
- to ``C:\TheRock\build``.
+ .. 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
- - Download link: `therock-dist-windows-gfx110X-dgpu-7.10.0.tar.gz
- `__
+ .. code-block:: cmd
- .. selected:: gfx=1101
+ 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 the tarball for your ``gfx1101`` GPU and extract the contents
- to ``C:\TheRock\build``.
+ - Download link: `therock-dist-windows-gfx120X-all-7.11.0.tar.gz
+ `__
- - Download link: `therock-dist-windows-gfx110X-dgpu-7.10.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
- .. selected:: gfx=1150
+ .. code-block:: cmd
- Download the tarball for your ``gfx1150`` GPU and extract the contents
- to ``C:\TheRock\build``.
+ 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-gfx1150-7.10.0.tar.gz
- `__
+ - Download link: `therock-dist-windows-gfx110X-all-7.11.0.tar.gz
+ `__
- .. selected:: gfx=1151
+ .. selected:: gpu=w6800 gpu=v620
- Download the tarball for your ``gfx1151`` GPU and extract the contents
- to ``C:\TheRock\build``.
+ .. code-block:: cmd
- - Download link: `therock-dist-windows-gfx1151-7.10.0.tar.gz
- `__
+ 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
+ `__
+
+ .. 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
+ `__
+
+ .. 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
+ `__
diff --git a/docs/install/includes/post-install.rst b/docs/install/includes/post-install.rst
index 57d0ef40d..0e2fc00c6 100644
--- a/docs/install/includes/post-install.rst
+++ b/docs/install/includes/post-install.rst
@@ -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
diff --git a/docs/install/includes/prerequisites.rst b/docs/install/includes/prerequisites.rst
index b9b69c7d7..7b7d239ef 100644
--- a/docs/install/includes/prerequisites.rst
+++ b/docs/install/includes/prerequisites.rst
@@ -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
-`.
+.. 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
+ `.
- .. 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 `.
- 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
- `__.
-
- * If you intend to run :ref:`ComfyUI workloads
- `, use driver version 25.20.01.17. For
- details and the download link, see `AMD Software: PyTorch on Windows
- Edition 7.1.1
- `__.
+ 2. Install AMD Software: Adrenalin Edition for Windows. For details and the
+ download link, see `AMD Software: Adrenalin Edition 26.1.1
+ `__.
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 --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
+.. ========================================== 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 `__ 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
diff --git a/docs/install/includes/selector.rst b/docs/install/includes/selector.rst
index 591100adf..c43069577 100644
--- a/docs/install/includes/selector.rst
+++ b/docs/install/includes/selector.rst
@@ -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
-
diff --git a/docs/install/includes/uninstall.rst b/docs/install/includes/uninstall.rst
index 34fd35fbb..8ece13f7b 100644
--- a/docs/install/includes/uninstall.rst
+++ b/docs/install/includes/uninstall.rst
@@ -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 ` 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 `, 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
`__.
diff --git a/docs/install/rocm.rst b/docs/install/rocm.rst
index ebf9edc8f..73c630c29 100644
--- a/docs/install/rocm.rst
+++ b/docs/install/rocm.rst
@@ -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 `.
.. raw:: html
-
+
diff --git a/docs/release/versions.md b/docs/release/versions.md
deleted file mode 100644
index 7373e1c7d..000000000
--- a/docs/release/versions.md
+++ /dev/null
@@ -1,28 +0,0 @@
-
-
-
-
-
-
-# ROCm preview release history
-
-| Version | Release date |
-| ------- | ------------ |
-| [7.10.0](https://rocm.docs.amd.com/en/7.10.0-preview/) | December 11, 2025 |
-| [7.9.0](https://rocm.docs.amd.com/en/7.9.0-preview/) | October 20, 2025 |
-
-```{important}
-ROCm 7.9.0 introduced a versioning discontinuity following the previous [7.0
-releases](https://rocm.docs.amd.com/en/latest/release/versions.html). Versions
-7.0 through 7.8 are reserved for production stream ROCm releases, while
-versions 7.9.0 and later listed on this page represent the technology preview
-release stream. Both streams share a largely similar code base but differ in
-their build systems. These differences include the CMake configuration,
-operating system package dependencies, and the integration of AMD GPU Driver
-components.
-
-Maintaining parallel release streams -- preview and production -- gives users
-ample time to evaluate and adopt the new build system and dependency changes.
-The technology preview stream is planned to continue through mid‑2026, after
-which it will replace the current production stream.
-```
diff --git a/docs/release/versions.rst b/docs/release/versions.rst
new file mode 100644
index 000000000..32b2da9eb
--- /dev/null
+++ b/docs/release/versions.rst
@@ -0,0 +1,38 @@
+:orphan:
+
+.. meta::
+ :description: ROCm preview release history
+ :keywords: documentation, rocm, amd, past, previous, rel, ver, versions, docs
+
+****************************
+ROCm preview release history
+****************************
+
+.. list-table::
+ :header-rows: 1
+
+ * - Version
+ - Release date
+
+ * - `7.11.0 `__
+ - February 11, 2026
+
+ * - `7.10.0 `__
+ - December 11, 2025
+
+ * - `7.9.0 `__
+ - October 20, 2025
+
+.. important::
+
+ ROCm 7.9.0 introduced a versioning discontinuity following the previous `7.0
+ releases `__.
+ Versions 7.0 through 7.8 are reserved for production stream ROCm releases,
+ while versions 7.9.0 and later listed on this page represent the technology
+ preview release stream. Both streams share a largely similar code base but
+ differ in their build systems.
+
+ Maintaining parallel release streams -- preview and production -- gives
+ users ample time to evaluate and adopt the new build system and dependency
+ changes. The technology preview stream is planned to continue through
+ mid‑2026, after which it will replace the current production stream.
diff --git a/docs/rocm-for-ai/pytorch-comfyui.rst b/docs/rocm-for-ai/pytorch-comfyui.rst
index ab1f4f383..12f192a32 100644
--- a/docs/rocm-for-ai/pytorch-comfyui.rst
+++ b/docs/rocm-for-ai/pytorch-comfyui.rst
@@ -18,7 +18,7 @@ showcasing AI-powered image generation.
:value: radeon-pro
:width: 3
- .. selector-option:: Radeon RX
+ .. selector-option:: Radeon
:value: radeon
:width: 3
@@ -27,62 +27,172 @@ showcasing AI-powered image generation.
:width: 3
.. selector:: Instinct GPU
- :key: gfx
+ :key: gpu
:show-when: fam=instinct
.. selector-info:: https://www.amd.com/en/products/accelerators/instinct.html
- .. selector-option:: Instinct MI355X
Instinct MI350X
- :value: 950
- :width: 4
+ .. selector-option:: MI355X
+ :width: 3
- .. selector-option:: Instinct MI325X
Instinct MI300X
Instinct MI300A
- :value: 942
- :width: 4
+ .. selector-option:: MI350X
+ :width: 3
- .. selector-option:: Instinct MI250X
Instinct MI250
Instinct MI210
- :value: 90a
- :width: 4
+ .. selector-option:: MI325X
+ :width: 3
+
+ .. selector-option:: MI300X
+ :width: 3
+
+ .. selector-option:: MI300A
+ :width: 3
+
+ .. selector-option:: MI250X
+ :width: 3
+
+ .. selector-option:: MI250
+ :width: 3
+
+ .. selector-option:: MI210
+ :width: 3
.. selector:: Radeon PRO GPU
- :key: gfx
+ :key: gpu
:show-when: fam=radeon-pro
.. selector-info:: https://www.amd.com/en/products/graphics/workstations.html
- .. selector-option:: Radeon PRO W7900D
Radeon PRO W7900
Radeon PRO W7800 48GB
Radeon PRO W7800
- :value: 1100
- :width: 6
+ .. selector-option:: AI PRO R9700
+ :value: ai-r9700
+ :width: 3
- .. selector-option:: Radeon PRO W7700
- :value: 1101
- :width: 6
+ .. selector-option:: AI PRO R9600D
+ :value: ai-r9600d
+ :width: 3
-.. selector:: Radeon RX GPU
- :key: gfx
+ .. selector-option:: W7900 Dual Slot
+ :value: w7900-dual-slot
+ :width: 3
+
+ .. selector-option:: W7900
+ :value: w7900
+ :width: 3
+
+ .. selector-option:: W7800 48GB
+ :value: w7800-48gb
+ :width: 3
+
+ .. selector-option:: W7800
+ :value: w7800
+ :width: 3
+
+ .. selector-option:: W7700
+ :value: w7700
+ :width: 3
+
+ .. selector-option:: V710
+ :value: v710
+ :width: 3
+
+.. selector:: Radeon GPU
+ :key: gpu
:show-when: fam=radeon
.. selector-info:: https://www.amd.com/en/products/graphics/desktops/radeon.html
- .. selector-option:: Radeon RX 7900 XTX
Radeon RX 7900 XT
Radeon RX 7900 GRE
- :value: 1100
+ .. selector-option:: RX 9070 XT
+ :value: rx-9070-xt
+ :width: 3
- .. selector-option:: Radeon RX 7800 XT
Radeon RX 7700 XT
- :value: 1101
+ .. selector-option:: RX 9070 GRE
+ :value: rx-9070-gre
+ :width: 3
+
+ .. selector-option:: RX 9070
+ :value: rx-9070
+ :width: 3
+
+ .. selector-option:: RX 9060 XT LP
+ :value: rx-9060-xt-lp
+ :width: 3
+
+ .. selector-option:: RX 9060 XT
+ :value: rx-9060-xt
+ :width: 3
+
+ .. selector-option:: RX 9060
+ :value: rx-9060
+ :width: 3
+
+ .. selector-option:: RX 7900 XTX
+ :value: rx-7900-xtx
+ :width: 3
+
+ .. selector-option:: RX 7900 XT
+ :value: rx-7900-xt
+ :width: 3
+
+ .. selector-option:: RX 7900 GRE
+ :value: rx-7900-gre
+ :width: 3
+
+ .. selector-option:: RX 7800 XT
+ :value: rx-7800-xt
+ :width: 3
+
+ .. selector-option:: RX 7700 XT
+ :value: rx-7700-xt
+ :width: 3
+
+ .. selector-option:: RX 7700
+ :value: rx-7700
+ :width: 3
.. selector:: Ryzen AI APU
- :key: gfx
+ :key: gpu
:show-when: fam=ryzen
.. selector-info:: https://www.amd.com/en/products/processors/workstations/mobile.html
- .. selector-option:: Ryzen AI Max+ PRO 395
Ryzen AI Max PRO 390, 385, 380
Ryzen AI Max+ 395
Ryzen AI Max 390, 385
- :value: 1151
- :width: 7
+ .. selector-option:: Max+ PRO 395
+ :value: max-pro-395
+ :width: 3
- .. selector-option:: Ryzen AI 9 HX 375
Ryzen AI 9 HX 370
Ryzen AI 9 365
- :value: 1150
- :width: 5
+ .. selector-option:: Max PRO 390
+ :value: max-pro-390
+ :width: 3
+
+ .. selector-option:: Max PRO 385
+ :value: max-pro-385
+ :width: 3
+
+ .. selector-option:: Max PRO 380
+ :value: max-pro-380
+ :width: 3
+
+ .. selector-option:: Max+ 395
+ :value: max-395
+ :width: 2
+
+ .. selector-option:: Max 390
+ :value: max-390
+ :width: 2
+
+ .. selector-option:: Max 385
+ :value: max-385
+ :width: 2
+
+ .. selector-option:: 9 HX 375
+ :value: 9-hx-375
+ :width: 2
+
+ .. selector-option:: 9 HX 370
+ :value: 9-hx-370
+ :width: 2
+
+ .. selector-option:: 9 365
+ :value: 9-365
+ :width: 2
.. selector:: Operating system
:key: os
@@ -111,13 +221,6 @@ showcasing AI-powered image generation.
Prerequisites
=============
-.. selected:: os=windows
-
- To run ComfyUI workloads on Windows, ensure you have Adrenalin Driver
- version 25.20.01.17. For details and the download link, see `AMD Software:
- PyTorch on Windows Edition 7.1.1
- `__. See the :ref:`related known issue `.
-
Ensure your system has a :ref:`supported Python version
` installed and accessible: 3.11, 3.12, or 3.13.
@@ -132,7 +235,7 @@ For prerequisite steps and post-installation recommendations, see the
:doc:`ROCm installation instructions `.
1. Set up your Python virtual environment. If you already have a successful
- :doc:`ROCm 7.10.0 installation using pip `, skip this step.
+ :doc:`ROCm 7.11.0 installation using pip `, skip this step.
For example, run the following command to create a virtual environment:
@@ -157,42 +260,54 @@ For prerequisite steps and post-installation recommendations, see the
3. Install the appropriate ROCm-enabled PyTorch build for your operating system
and AMD hardware architecture.
- .. selected:: gfx=950
+ .. selected:: gpu=mi355x gpu=mi350x
.. code-block:: bash
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx950-dcgpu/ torch torchvision torchaudio
- .. selected:: gfx=942
+ .. selected:: gpu=mi325x gpu=mi300x gpu=mi300a
.. code-block:: bash
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx94X-dcgpu/ torch torchvision torchaudio
- .. selected:: gfx=90a
+ .. selected:: gpu=mi250x gpu=mi250 gpu=mi210
.. code-block:: bash
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx90X-dcgpu/ torch torchvision torchaudio
- .. selected:: gfx=1151
+ .. 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
+
+ python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx120X-all/ torch torchvision torchaudio
+
+ .. 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
+
+ python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx110X-dgpu/ torch torchvision torchaudio
+
+ .. selected:: gpu=w6800 gpu=v620
+
+ .. code-block:: bash
+
+ python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx103X-dgpu/ torch torchvision torchaudio
+
+ .. 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
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1151/ torch torchvision torchaudio
- .. selected:: gfx=1150
+ .. selected:: gpu=9-hx-375 gpu=9-hx-370 gpu=9-365
.. code-block:: bash
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1150/ torch torchvision torchaudio
- .. selected:: gfx=1100 gfx=1101
-
- .. code-block:: bash
-
- python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx110X-dgpu/ torch torchvision torchaudio
-
4. Check your PyTorch installation.
.. code-block:: shell
diff --git a/docs/sphinx/_toc.yml.in b/docs/sphinx/_toc.yml.in
index 1a3599404..27a032844 100644
--- a/docs/sphinx/_toc.yml.in
+++ b/docs/sphinx/_toc.yml.in
@@ -30,3 +30,7 @@ subtrees:
entries:
- file: rocm-for-ai/pytorch-comfyui.rst
title: Install PyTorch and ComfyUI
+ - caption: Tutorials
+ entries:
+ - url: https://github.com/ROCm/rocm-examples/tree/release/therock-7.11
+ title: ROCm examples
diff --git a/docs/sphinx/requirements.in b/docs/sphinx/requirements.in
index 86bd986bd..667526b0a 100644
--- a/docs/sphinx/requirements.in
+++ b/docs/sphinx/requirements.in
@@ -1,2 +1,3 @@
-rocm-docs-core==1.31.0
+rocm-docs-core==1.31.3
sphinx-sitemap
+ckdl
diff --git a/docs/sphinx/requirements.txt b/docs/sphinx/requirements.txt
index d7826c038..f877dfab9 100644
--- a/docs/sphinx/requirements.txt
+++ b/docs/sphinx/requirements.txt
@@ -2,7 +2,7 @@
# This file is autogenerated by pip-compile with Python 3.10
# by the following command:
#
-# pip-compile --cert=None --client-cert=None --index-url=None --pip-args=None docs/sphinx/requirements.in
+# pip-compile docs/sphinx/requirements.in
#
accessible-pygments==0.0.5
# via pydata-sphinx-theme
@@ -15,7 +15,7 @@ attrs==25.4.0
# jsonschema
# jupyter-cache
# referencing
-babel==2.17.0
+babel==2.18.0
# via
# pydata-sphinx-theme
# sphinx
@@ -23,7 +23,7 @@ beautifulsoup4==4.14.3
# via pydata-sphinx-theme
breathe==4.36.0
# via rocm-docs-core
-certifi==2025.11.12
+certifi==2026.1.4
# via requests
cffi==2.0.0
# via
@@ -31,15 +31,17 @@ cffi==2.0.0
# pynacl
charset-normalizer==3.4.4
# via requests
+ckdl==1.0
+ # via -r docs/sphinx/requirements.in
click==8.3.1
# via
# jupyter-cache
# sphinx-external-toc
comm==0.2.3
# via ipykernel
-cryptography==46.0.3
+cryptography==46.0.4
# via pyjwt
-debugpy==1.8.17
+debugpy==1.8.20
# via ipykernel
decorator==5.2.1
# via ipython
@@ -58,21 +60,21 @@ fastjsonschema==2.21.2
# rocm-docs-core
gitdb==4.0.12
# via gitpython
-gitpython==3.1.45
+gitpython==3.1.46
# via rocm-docs-core
-greenlet==3.3.0
+greenlet==3.3.1
# via sqlalchemy
idna==3.11
# via requests
imagesize==1.4.1
# via sphinx
-importlib-metadata==8.7.0
+importlib-metadata==8.7.1
# via
# jupyter-cache
# myst-nb
ipykernel==7.1.0
# via myst-nb
-ipython==8.37.0
+ipython==8.38.0
# via
# ipykernel
# myst-nb
@@ -82,13 +84,13 @@ jinja2==3.1.6
# via
# myst-parser
# sphinx
-jsonschema==4.25.1
+jsonschema==4.26.0
# via nbformat
jsonschema-specifications==2025.9.1
# via jsonschema
jupyter-cache==1.0.1
# via myst-nb
-jupyter-client==8.6.3
+jupyter-client==8.8.0
# via
# ipykernel
# nbclient
@@ -116,7 +118,7 @@ myst-nb==1.3.0
# via rocm-docs-core
myst-parser==4.0.1
# via myst-nb
-nbclient==0.10.2
+nbclient==0.10.4
# via
# jupyter-cache
# myst-nb
@@ -127,7 +129,7 @@ nbformat==5.10.4
# nbclient
nest-asyncio==1.6.0
# via ipykernel
-packaging==25.0
+packaging==26.0
# via
# ipykernel
# pydata-sphinx-theme
@@ -140,13 +142,13 @@ platformdirs==4.5.1
# via jupyter-core
prompt-toolkit==3.0.52
# via ipython
-psutil==7.1.3
+psutil==7.2.2
# via ipykernel
ptyprocess==0.7.0
# via pexpect
pure-eval==0.2.3
# via stack-data
-pycparser==2.23
+pycparser==3.0
# via cffi
pydata-sphinx-theme==0.15.4
# via
@@ -160,9 +162,9 @@ pygments==2.19.2
# ipython
# pydata-sphinx-theme
# sphinx
-pyjwt[crypto]==2.10.1
+pyjwt[crypto]==2.11.0
# via pygithub
-pynacl==1.6.1
+pynacl==1.6.2
# via pygithub
python-dateutil==2.9.0.post0
# via jupyter-client
@@ -185,7 +187,7 @@ requests==2.32.5
# via
# pygithub
# sphinx
-rocm-docs-core==1.31.0
+rocm-docs-core==1.31.3
# via -r docs/sphinx/requirements.in
rpds-py==0.30.0
# via
@@ -197,7 +199,7 @@ smmap==5.0.2
# via gitdb
snowballstemmer==3.0.1
# via sphinx
-soupsieve==2.8
+soupsieve==2.8.3
# via beautifulsoup4
sphinx==8.1.3
# via
@@ -211,6 +213,7 @@ sphinx==8.1.3
# sphinx-design
# sphinx-external-toc
# sphinx-last-updated-by-git
+ # sphinx-multitoc-numbering
# sphinx-notfound-page
sphinx-book-theme==1.1.4
# via rocm-docs-core
@@ -218,10 +221,12 @@ sphinx-copybutton==0.5.2
# via rocm-docs-core
sphinx-design==0.6.1
# via rocm-docs-core
-sphinx-external-toc==1.0.1
+sphinx-external-toc==1.1.0
# via rocm-docs-core
sphinx-last-updated-by-git==0.3.8
# via sphinx-sitemap
+sphinx-multitoc-numbering==0.1.3
+ # via sphinx-external-toc
sphinx-notfound-page==1.1.0
# via rocm-docs-core
sphinx-sitemap==2.9.0
@@ -238,15 +243,15 @@ sphinxcontrib-qthelp==2.0.0
# via sphinx
sphinxcontrib-serializinghtml==2.0.0
# via sphinx
-sqlalchemy==2.0.44
+sqlalchemy==2.0.46
# via jupyter-cache
stack-data==0.6.3
# via ipython
tabulate==0.9.0
# via jupyter-cache
-tomli==2.3.0
+tomli==2.4.0
# via sphinx
-tornado==6.5.2
+tornado==6.5.4
# via
# ipykernel
# jupyter-client
@@ -270,11 +275,11 @@ typing-extensions==4.15.0
# pygithub
# referencing
# sqlalchemy
-urllib3==2.6.1
+urllib3==2.6.3
# via
# pygithub
# requests
-wcwidth==0.2.14
+wcwidth==0.5.3
# via prompt-toolkit
zipp==3.23.0
# via importlib-metadata
diff --git a/docs/sphinx/static/next-button-install-page.js b/docs/sphinx/static/next-button-install-page.js
deleted file mode 100644
index 31e3b5bab..000000000
--- a/docs/sphinx/static/next-button-install-page.js
+++ /dev/null
@@ -1,7 +0,0 @@
-document.addEventListener("DOMContentLoaded", () => {
- const nextLink = document.querySelector("footer.prev-next-footer a.right-next");
- const nextTitle = nextLink.querySelector(".prev-next-title");
- console.log(nextLink);
- nextTitle.textContent = "Build the ROCm Core SDK from source";
- nextLink.href = "./build-from-source.html";
-});
diff --git a/docs/sphinx/static/setup-toc-install-headings.js b/docs/sphinx/static/setup-toc-install-headings.js
index 0764c1ad3..c1818fe36 100644
--- a/docs/sphinx/static/setup-toc-install-headings.js
+++ b/docs/sphinx/static/setup-toc-install-headings.js
@@ -27,10 +27,10 @@ function getDocsRoot() {
// HACK:
// Look for version pattern: at least two dots (e.g., 6.4.3, 7.10.0-preview)
- const versionIdx = parts.findIndex(part =>
+ const versionIdx = parts.findIndex(part =>
(part.match(/\./g) || []).length >= 2 || /^\d+$/.test(part)
);
-
+
if (versionIdx !== -1) {
return "/" + parts.slice(0, versionIdx + 1).join("/") + `/${INSTALL_PAGE_DIR}/`;
}
@@ -40,6 +40,15 @@ function getDocsRoot() {
}
function buildHref(docsRoot, page, hash) {
+ // If already on the install page, just use hash anchors
+ const pathname = window.location.pathname;
+ const isOnInstallPage = pathname.endsWith(`/${INSTALL_PAGE_DIR}/${INSTALL_PAGE_FILE}`) ||
+ pathname.endsWith(`/${INSTALL_PAGE_FILE}`);
+
+ if (isOnInstallPage && hash) {
+ return `#${hash}`;
+ }
+
return `${docsRoot}${page}${hash ? "#" + hash : ""}`;
}