# GPU Linux

## About GPU Linux

GPU Linux is a documentation project designed to simplify the installation, configuration, and optimization of GPU drivers on Linux, providing essential information in an easily accessible format. It serves as a reliable resource for gaming, video editing, and high-performance computing. This documentation is a free, collaborative, and open project, continuously enhanced through contributions from the community. All ideas, suggestions, corrections, and improvements are welcome. To contribute to the project, join the Telegram group: <https://t.me/+bRjQVsxdB-dhZWFh>. Document: <https://gpulinux.gitbook.io/gpulinux/>

## AMD

### Drivers Resume

| Driver |                 AMD                |                 Open Source                 |
| :----: | :--------------------------------: | :-----------------------------------------: |
| OpenGL |    AMD PRO OpenGL Driver (OGLP)    |              Mesa OpenGL Driver             |
| OpenCL | ROCr (Radeon Open Compute Runtime) | Mesa OpenCL ICD (Installable Client Driver) |
| Vulkan |            AMDVLK / PRO            |                     RADV                    |

### AMD Drivers

Access <https://www.amd.com/en/support/download/linux-drivers.html>, download and install the  *amdgpu-install* package.

Usage:\
amdgpu-install --usecase=\<options> --opengl=\<options> --opencl=\<options> --vulkan=\<options>

For more information: $amdgpu-install --help

If --usecase option is not present, the default selection is "dkms,graphics,opencl,hip".

| --usecase=   | Description                                                                                                                                                                                 | Application                                                          |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| dkms         | <ul><li>Kernel mode driver (included in all usecases)</li></ul>                                                                                                                             | to only install the kernel mode driver                               |
| graphics     | <ul><li>Open source Mesa 3D graphics and multimedia libraries</li></ul>                                                                                                                     | for users of graphics applications                                   |
| multimedia   | <ul><li>Open source Mesa 3D multimedia libraries</li></ul>                                                                                                                                  | for users of open source multimedia                                  |
| workstation  | <ul><li>Open source multimedia libraries</li><li>Closed source (legacy) OpenGL</li></ul>                                                                                                    | for users of legacy WS applications                                  |
| rocm         | <ul><li>OpenCL (ROCr/KFD based) runtime</li><li>HIP runtimes</li><li>Machine learning framework</li><li>All ROCm libraries and applications</li></ul>                                       | for users and developers requiring full ROCm stack                   |
| wsl          | <ul><li>ROCr WSL runtime library (Ubuntu 22.04 only)</li></ul>                                                                                                                              | for using ROCm in a WSL context                                      |
| rocmdev      | <p></p><ul><li>HIP runtimes</li><li>OpenCL runtime</li><li>Profiler, Tracer and Debugger tools</li></ul>                                                                                    | for developers requiring ROCm runtime and profiling/debugging tools  |
| rocmdevtools | <ul><li>Profiler, Tracer and Debugger tools</li></ul>                                                                                                                                       | for developers requiring ROCm profiling/debugging tools              |
| amf          | <ul><li>AMF closed source multimedia library</li></ul>                                                                                                                                      | for users of AMF based multimedia                                    |
| lrt          | <ul><li>ROCm Compiler and device libraries</li><li>ROCr runtime and thunk</li></ul>                                                                                                         | for users of applications requiring ROCm runtime                     |
| opencl       | <ul><li>ROCr based OpenCL</li><li>ROCm Language runtime</li></ul>                                                                                                                           | for users of applications requiring OpenCL on Vega or later products |
| openclsdk    | <ul><li>ROCr based OpenCL</li><li>ROCm Language runtime</li><li>Development and SDK files for ROCr based OpenCL</li></ul>                                                                   | for application developers requiring ROCr based OpenCL               |
| hip          | <ul><li>HIP runtimes</li></ul>                                                                                                                                                              | for users of HIP runtime on AMD products                             |
| hiplibsdk    | <ul><li>HIP runtimes</li><li>ROCm math libraries</li><li>HIP development libraries</li></ul>                                                                                                | for application developers requiring HIP on AMD products             |
| openmpsdk    | <ul><li>OpenMP runtime and devel packages</li></ul>                                                                                                                                         | for users of openmp/flang on AMD products                            |
| mllib        | <ul><li>MIOpen hip/tensile libraries</li><li>Clang OpenCL</li><li>MIOpen kernels</li></ul>                                                                                                  | for users executing machine learning workloads                       |
| mlsdk        | <ul><li>MIOpen development libraries</li><li>Clang OpenCL development libraries</li><li>MIOpen kernels</li></ul>                                                                            | for developers executing machine learning workloads                  |
| asan         | <p></p><ul><li>ASAN enabled OpenCL (ROCr/KFD based) runtime</li><li>ASAN enabled HIP runtimes</li><li>ASAN enabled Machine learning framework</li><li>ASAN enabled ROCm libraries</li></ul> | for users of ASAN enabled ROCm packages                              |

| --opengl= | Description                                                                                | Compatibility                                                                                                                                                                                                                                                   |
| --------- | ------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| mesa      | <ul><li>Installs the open-source Mesa 3D driver, widely used for OpenGL support.</li></ul> | <ul><li>It is recommended for users who want stable and reliable performance in desktop applications and games, especially on modern Linux systems.</li><li>Suitable for most modern AMD GPUs.</li></ul>                                                        |
| oglp      | <ul><li>An OpenGL driver intended for cloud or other specific applications. </li></ul>     | <ul><li>Used in specific configurations for cloud computing or other needs that require a customized OpenGL implementation.</li><li>It is available only for Ubuntu 20.04. Not recommended or needed for general users or for Ubuntu 24.04 or higher.</li></ul> |

| --opencl= | Description                      | Compatibility                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| --------- | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| rocr      | <p>ROCr/KFD based OpenCL<br></p> | Modern GPUs: For GPUs based on GCN 3.0 (Fiji) architectures or later (such as Polaris, Vega, RDNA, etc.).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| legacy    | DEPRECATED                       | <p>This option should be used for GPUs based on the following architectures:</p><ul><li><p><strong>Southern Islands (SI)</strong>:</p><ul><li>Radeon HD 7000 Series.</li><li>GPUs such as HD 7750, HD 7770, HD 7850, HD 7870, HD 7950, HD 7970.</li></ul></li><li><p><strong>Sea Islands (CI)</strong>:</p><ul><li>Radeon HD 8000 Series.</li><li>GPUs such as HD 8350, HD 8490, HD 8570, HD 8770, HD 8870.</li></ul></li><li><p><strong>APUs and GPUs prior to full ROCr support</strong>:</p><ul><li>AMD APUs based on Kaveri, Kabini, or older architectures.</li><li>Integrated GPUs such as Radeon R5/R7 prior to the Vega series.</li></ul></li></ul> |

| --vulkan= | Description                                                                                                                                                                                                                                                                                                                                                  | Compatibility                                                                                                                                                                                                                                                                                                                                    |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| amdvlk    | <p>AMD open source implementation</p><ul><li>Installs the AMD open-source Vulkan implementation.</li><li>Suitable for users who prefer open-source drivers and compatibility with Vulkan-based applications and games.</li><li>Recommended for most use cases on Linux where AMD Vulkan drivers are needed and open-source stability is preferred.</li></ul> | <ul><li>AMD Radeon™ RX 7000</li><li>AMD Radeon™ RX 6000</li><li>AMD Radeon™ VII AMD</li><li>Radeon™ RX 5000 AMD</li><li>Radeon™ RX Vega AMD</li><li>Radeon™ RX 500 AMD</li><li>Radeon™ RX 400 AMD</li><li>Radeon™ R9 Fury / Fury X / Nano</li><li>AMD Radeon™ R9 360 / 380 / 380X / 390 / 390X</li><li>AMD Radeon™ R9 285 / 290 / 290X</li></ul> |
| pro       | <p>AMD closed source implementation</p><ul><li>Installs the AMD closed-source Vulkan implementation.</li><li>Provides optimized Vulkan performance for specific applications and workloads.</li><li>Typically used in professional or enterprise contexts where performance is a critical factor and the closed-source driver is better supported.</li></ul> | <ul><li>AMD Radeon™ PRO W7000</li><li>AMD Radeon™ PRO W6000</li><li>AMD Radeon™ PRO VII</li><li>AMD Radeon™ PRO W5000</li><li>Radeon™ PRO WX x200</li><li>Radeon™ PRO WX x100</li><li>Radeon™ PRO AMD</li><li>Radeon™ Pro Duo</li><li>FirePro™ Wx100</li><li>FirePro™ Wx000</li></ul>                                                            |

### Open Source Drivers

* OpenGL\
  $sudo apt install mesa-va-drivers libgl1-mesa-dri libgbm1 mesa-utils
* OpenCL\
  $sudo apt install mesa-opencl-icd ocl-icd-libopencl1 clinfo
* Vulkan\
  $sudo apt install mesa-vulkan-drivers vulkan-tools

### Examples

* For video editing:\
  $sudo amdgpu-install --usecase=graphics,multimedia,opencl,amf,hip,rocm --opengl=mesa --opencl=rocr --vulkan=amdvlk\
  $sudo apt install mesa-utils clinfo vulkan-tools
* For gaming:\
  $sudo amdgpu-install --usecase=graphics --opengl=mesa\
  $sudo apt install mesa-va-drivers libgl1-mesa-dri libgbm1 mesa-utils\
  $sudo apt install mesa-opencl-icd ocl-icd-libopencl1 clinfo\
  $sudo apt install mesa-vulkan-drivers vulkan-tools

### Settings

* Add permission for Render/Video\
  $sudo usermod -a -G render,video $LOGNAME
* Include in \~/.bashrc\
  export LD\_LIBRARY\_PATH=/opt/amdgpu/lib/x86\_64-linux-gnu:$LD\_LIBRARY\_PATH\
  export PATH=/opt/amdgpu/bin:$PATH

### Utilities

* Check OpenGL: $glxinfo | grep OpenGL
* Check OpenGL: $xeglgears
* Check OpenCL: $clinfo
* Check Vulkan: $vulkaninfo | grep "GPU"

### References

* Linux® Drivers for AMD Radeon™ and Radeon PRO™ Graphics\
  <https://www.amd.com/en/support/download/linux-drivers.html>&#x20;
* Radeon™ Software for Linux® Installation\
  <https://amdgpu-install.readthedocs.io/en/latest/preamble.html>

## Intel

\<missing>

## NVIDIA

\<missing>

## Video Editing

### Codecs & Plugins

$sudo apt install lsp-plugins alsa-utils lmms libxine2-plugins gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav libvdpau-va-gl1 libx264-dev libx265-dev libavcodec-extra ffmpeg ubuntu-restricted-extras

### DaVinci Resolve

* This repo allows you to package DaVinci Resolve as a Flatpak for use on Linux Flatpak based systems, especially e.g. Fedora Silverblue where there aren't easier installation options.\
  <https://github.com/pobthebuilder/resolve-flatpak>
* Install DaVinci Resolve or DaVinci Resolve Studio on Debian (convert .run in .deb)\
  <https://www.danieltufvesson.com/makeresolvedeb>
* DaVinci Resolve on Linux (Debian) - with media tips\
  <https://github.com/flolu/davinci-resolve-linux>

### Kdenlive

\<missing>

### Blender

* ZLUDA is a drop-in replacement for CUDA on non-NVIDIA GPU. ZLUDA allows to run unmodified CUDA applications using non-NVIDIA GPUs with near-native performance.\
  <https://github.com/vosen/ZLUDA>

## Updates

\[2024.12.24] Shaba Piffer: First Version; About, AMD, Video Editing, Updates.

\[YYYY.MM.DD] Name: Updates.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gpulinux.gitbook.io/gpulinux/gpu-linux.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.