Using the amdgpu-install Script

Script Types

The AMDGPU stack offers the following script to help you install a coherent set of stack components:

  • amdgpu-install

This script supports a set of arguments that are explained in the following sections of this page.

Invoking the amdgpu-install Script

Once you have installed the installer package, invoke the script as amdgpu-install from a terminal.

Note

Use of the -y option is recommended to avoid prompts from the package manager.

Scenarios

Specifying an OpenCL Implementation

There is currently only one OpenCL implementations available:

  • ROCr: Provides support for Vega 10 and newer hardware.

Note

To use the ROCr implementation of OpenCL, the running user might need additional permissions. Usually the user must be added to the “render” group or to the “video” group. See the notes in OpenCL (Optional Component) for more details.

OpenCL is installed using the --opencl option, as follows:

Option

Description

--opencl=rocr

Installs ROCr OpenCL.

Specifying a Vulkan Implementation

There are two Vulkan implementations available:

  • AMDVLK: Provides open source Vulkan

  • PRO: Provides PRO vulkan (Proprietary, requires EULA acceptance)

You can either install one or both implementations.

Vulkan is installed using the --vulkan option, as follows:

Option

Description

--vulkan=amdvlk

Installs open source Vulkan

--vulkan=pro

Installs PRO Vulkan (Proprietary)

--vulkan=amdvlk,pro

Installs both open and PRO Vulkan.

Viewing Help or Usage Output

Executing the script with -h or --help argument provides the help or usage output.

$ amdgpu-install -h

Adding Advanced Package Management Functionality

More advanced functionality can be obtained by providing the installation script with arguments to pass through to the package management software of the distribution you are using.