Install AMD Finance

Install AMD Finance#

2026-07-30

3 min read time

Applies to Linux

This page provides brief guidance and recommendations on setting up a ROCm-enabled environment for financial computing workloads. This includes pulling and running prebuilt ROCm Docker images for supported Ubuntu versions and installing AMD Finance libraries such as XGBoost, LightGBM, and ThunderGBM.

Before proceeding, ensure your system meets the supported hardware and software configurations outlined in AMD Finance installation prerequisites.

Install ROCm#

To get up and running quickly, a prebuilt ROCm-enabled container is recommended. The easiest way is to use the official ROCm Docker images from Docker Hub. See Docker images in the ROCm ecosystem for more information.

  1. Pull a ROCm dev Docker image with a supported configuration (see Docker Hub to browse available images). For example:

    docker pull rocm/dev-ubuntu-24.04:7.2.3-complete

    Note

    LightGBM and ThunderGBM are not supported on ROCm 7.2.3.

    See rocm/dev-ubuntu-24.04:7.2.3-complete on Docker Hub.

    docker pull rocm/dev-ubuntu-24.04:7.1.1-complete

    Note

    LightGBM and ThunderGBM are not supported on ROCm 7.1.1.

    See rocm/dev-ubuntu-24.04:7.1.1-complete on Docker Hub.

    docker pull rocm/dev-ubuntu-24.04:7.0.2-complete

    See rocm/dev-ubuntu-24.04:7.0.2-complete on Docker Hub.

    docker pull rocm/dev-ubuntu-24.04:6.4.4-complete

    See rocm/dev-ubuntu-24.04:6.4.4-complete on Docker Hub.

  2. Launch the Docker container.

    Note

    LightGBM and ThunderGBM are not supported on ROCm 7.2.3.

    docker run -it \
    --cap-add=SYS_PTRACE \
    --ipc=host \
    --privileged=true \
    --shm-size=128GB \
    --network=host \
    --device=/dev/kfd \
    --device=/dev/dri \
    --group-add video \
    -v $HOME:$HOME \
    --name rocm723 \
    rocm/dev-ubuntu-24.04:7.2.3-complete

    Note

    LightGBM and ThunderGBM are not supported on ROCm 7.1.1.

    docker run -it \
    --cap-add=SYS_PTRACE \
    --ipc=host \
    --privileged=true \
    --shm-size=128GB \
    --network=host \
    --device=/dev/kfd \
    --device=/dev/dri \
    --group-add video \
    -v $HOME:$HOME \
    --name rocm711 \
    rocm/dev-ubuntu-24.04:7.1.1-complete

    docker run -it \
    --cap-add=SYS_PTRACE \
    --ipc=host \
    --privileged=true \
    --shm-size=128GB \
    --network=host \
    --device=/dev/kfd \
    --device=/dev/dri \
    --group-add video \
    -v $HOME:$HOME \
    --name rocm702 \
    rocm/dev-ubuntu-24.04:7.0.2-complete

    docker run -it \
    --cap-add=SYS_PTRACE \
    --ipc=host \
    --privileged=true \
    --shm-size=128GB \
    --network=host \
    --device=/dev/kfd \
    --device=/dev/dri \
    --group-add video \
    -v $HOME:$HOME \
    --name rocm644 \
    rocm/dev-ubuntu-24.04:6.4.4-complete

Install AMD Finance libraries#

Each library can have unique prerequisite and environment requirements. To avoid dependency conflicts and configuration errors, ensure each library is installed individually rather than through a unified installation process.

The installation instructions for each library on ROCm can be found as follows: