Installation Prerequisites (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
orvideo
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