How to Install AMD OpenCL Mining Drivers on Debian 11 Bullseye

The new method gives us a pretty seamless install of AMD OpenCL drivers on Debian 11. Tested on the RX 580.
Table of Contents

    This is a new one that works great and Debian is a super stable Linux variation that’s mostly compatible with Ubuntu but does not include any bleeding edge software. Debian is stable and that’s the whole point. It’s great for server installations and mining rigs.

    Let’s install Debian 11.

    Install Debian 11 Bullseye

    You can install Debian 11 from USB using programs like Ventoy, Rufus

    If you are using Linux you can write the image using dd.

    sudo dd if=debian-11.3.0-amd64-netinst.iso of=/dev/sd* bs=1024k status=progress

    You will be asked if you want to install a desktop environment during the installation. The preferred option is to use the desktop environment with XFCE and SSH.

    Debian 11 Desktop installer image
    Debian 11 Xfce Desktop Installer

    Once completed you will be presented with the desktop. I use the root account for this install.

    Open the terminal and do an update to check it’s fully updated.

    apt update && apt-upgrade -y

    Add Non-Free Repository Sources

    Add the non-free repositories to Debian /etc/apt/sources.list

    You can use nano /etc/apt/sources/list

    Edit the file to look like the below. You are just adding contrib non-free to each line.

    deb bullseye main contrib non-free
    deb-src bullseye main contrib non-free
    deb bullseye-security main contrib non-free
    deb-src bullseye-security main contrib non-free
    # bullseye-updates, to get updates before a point release is made;
    # see
    deb bullseye-updates main contrib non-free
    deb-src bullseye-updates main contrib non-free

    Installing AMD GPU Firmware

    Update the packages. Feel free to fully update and upgrade if you like. It won’t make any difference.

    apt update

    Next, we install the non-free graphic cards drivers with:

    apt install firmware-linux-nonfree

    You may get some errors about missing firmware. You can safely ignore it we won’t be needing it anyway.

    Non-free means, not open source, AMD drivers are proprietary so hence the non-free part. It doesn’t mean you have to pay anything means that the software cannot be distributed and or modified, sold etc.

    Downloading AMD GPU OpenCL Drivers

    Next, we can go down the familiar route explained in previous guides. Download the old AMD drivers and install them with the following commands.

    # Change to a directory to download the file
    cd Downloads
    # Download the tar file of AMD drivers
    wget --referer
    # unzip the tar
    tar -xJpf amdgpu-pro-*.tar.xz
    # cd into the directory
    cd amdgpu-pro-20.40-1147286-ubuntu-20.04

    Installing AMD GPU OpenCL Drivers

    Next, the command to install only the OpenCL drivers

    ./amdgpu-install --opencl=legacy --headless --no-dkms

    The command should complete without error.

    At this point, you can use clinfo to see if it recognises your gfx card.

    apt install clinfo

    Your computer should be mining now using Debian 11. This method was tested on RX 580 and works every time.


    At this point, you could install CoreCtl to overclock your cards in a GUI application.

    The Install for CoreCtl is at the bottom of another guide I wrote.

    Share This Guide!