Skip to main content
Version: 0.6 (Latest)

Vulkan requirements

Raptor Guide requires Vulkan version 1.3 as well as the following device features:

  • VkPhysicalDeviceVulkan12Features
    • bufferDeviceAddress
  • VkPhysicalDeviceVulkan13Features
    • dynamicRendering
    • synchronization2
    • maintenance4

Check support​

To check if the system support the Vulkan device features listed, run the following command:

$ vulkaninfo | grep '\<bufferDeviceAddress\>\|\<dynamicRendering\>\|\<synchronization2\>\|\<maintenance4\>'

If a feature is missing or states false, the system will not be able to run Raptor Guide.

Example output:

        bufferDeviceAddress              = true
        bufferDeviceAddress                                = true
        synchronization2                                   = true
        dynamicRendering                                   = true
        maintenance4                                       = true
        bufferDeviceAddress                                = true
        synchronization2                                   = true
        dynamicRendering                                   = true
        maintenance4                                       = true

GPU Selection on Multi-GPU Systems​

On systems with multiple GPUs (e.g., a discrete NVIDIA/AMD GPU and an integrated Intel GPU), you can control which GPU Raptor Guide uses by setting the MESA_VK_DEVICE_SELECT environment variable.

Step 1: Find your GPU's vendor and device ID​

  1. Open a terminal
  2. Run
vulkaninfo | grep VkPhysicalDeviceProperties -A 8
  1. For the GPU you want to use (deviceName), note the vendorID and deviceID values (hexadecimal format).

Example output:

VkPhysicalDeviceProperties:
---------------------------
        apiVersion        = 1.4.303 (4210991)
        driverVersion     = 570.195.3.0 (2393948352)
        vendorID          = 0x10de
        deviceID          = 0x24b0
        deviceType        = PHYSICAL_DEVICE_TYPE_DISCRETE_GPU
        deviceName        = NVIDIA RTX A4000
        pipelineCacheUUID = 67f4e1ad-4189-4a4f-5fa3-f38a6feaa95b

Step 2: Set the MESA_VK_DEVICE_SELECT environment variable​

Set the environment variable using the vendor and device IDs you found. The format is:

MESA_VK_DEVICE_SELECT=vendorID:deviceID!

Example:

To select an NVIDIA RTX A4000 with vendorID 10de and deviceID 24b0:

export MESA_VK_DEVICE_SELECT=10de:24b0!

Note: The trailing ! forces the selection and prevents fallback to other devices. This can affect other applications as well.

Or set it when running your application:

MESA_VK_DEVICE_SELECT=10de:24b0! ./your_application