Installation Prerequisites (Linux)#

Applies to Linux

2023-06-02

5 min read time

You must perform the following steps before installing ROCm and check if the system meets all the requirements to proceed with the installation.

Confirm the System Has a Supported Linux Distribution Version#

The ROCm installation is supported only on specific Linux distributions and kernel versions.

Check the Linux Distribution and Kernel Version on Your System#

This section discusses obtaining information about the Linux distribution and kernel version.

Linux Distribution Information#

Verify the Linux distribution using the following steps:

To obtain the Linux distribution information, type the following command on your system from the Command Line Interface (CLI):
```
uname -m && cat /etc/*release
```
Confirm that the obtained Linux distribution information matches with those listed in Supported Distributions.

Example: Running the command above on an Ubuntu system results in the following output:
```
x86_64
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=20.04
DISTRIB_CODENAME=focal
DISTRIB_DESCRIPTION="Ubuntu 20.04.5 LTS"
```

Kernel Information#

Verify the kernel version using the following steps:

To check the kernel version of your Linux system, type the following command:
```
uname -srmv
```
Confirm that the obtained kernel version information matches with System Requirements.

Example: The output of the command above lists the kernel version in the following format:
```
Linux 5.15.0-46-generic #44~20.04.5-Ubuntu SMP Fri Jun 24 13:27:29 UTC 2022 x86_64
```

Setting Permissions for Groups#

This section provides steps to add any current user to a video group to access GPU resources.

To check the groups in your system, issue the following command:
```
groups
```

Add yourself to the render or video group using the following instruction:

sudo usermod -a -G render $LOGNAME
# OR
sudo usermod -a -G video $LOGNAME

Use of the video group is recommended for all ROCm-supported operating systems.

To add all future users to the video and render groups by default, run the following commands:

echo 'ADD_EXTRA_GROUPS=1' | sudo tee -a /etc/adduser.conf
echo 'EXTRA_GROUPS=video' | sudo tee -a /etc/adduser.conf
echo 'EXTRA_GROUPS=render' | sudo tee -a /etc/adduser.conf

Installation Prerequisites (Linux)

Contents