Linux Environment Setup - PilotLightTech/pilotlight GitHub Wiki

Installing Package Dependencies

Run the following in a bash terminal for the target OS.

Ubuntu

sudo apt install \
    git \
    libx11-dev \
    libx11-xcb-dev \
    libxkbcommon-x11-dev \
    libxcb-cursor-dev \
    libxcb-xfixes0-dev \
    libxcb-keysyms1-dev \
    libxcursor-dev \
    libxrandr-dev \
    libxinerama-dev \
    libgl-dev \
    libxi-dev

RHEL8

sudo dnf install \
    git \
    libX11-devel \
    xcb-util-devel \
    libxkbcommon-x11-devel \
    xcb-util-cursor-devel \
    libxcb-devel \
    xcb-util-keysyms-devel \
    libXcursor-devel \
    libXrandr-devel \
    libXinerama-devel \
    mesa-libGL-devel \
    libXi-devel

Installing the VulkanSDK

If installing Vulkan for the first time, run the following in a bash terminal to install the VulkanSDK Tarball for x86_64 systems. Note that $sdkVersion may be modified as needed.

[!NOTE]
For Ubuntu users, the Vulkan SDK can be installed via the default package manager. However, support will be depreciated in May 2025 and the below method will be preferred going forward.

sdkVersion=1.3.236.0
outDirectory=/opt/vulkansdk
sdkTar=vulkansdk-linux-x86_64-$sdkVersion.tar.gz

sudo rm -rf $outDirectory
wget -P /tmp https://sdk.lunarg.com/sdk/download/$sdkVersion/linux/$sdkTar
sudo mkdir -p $outDirectory
sudo tar -xf /tmp/$sdkTar -C $outDirectory
rm -f /tmp/$sdkTar
sudo wget -P $outDirectory https://sdk.lunarg.com/sdk/download/$sdkVersion/linux/config.json

Additionally, append the following to your bash environment (e.g. ~/.bashrc), again updating the version number as needed:

export VULKAN_SDK=/opt/vulkansdk/1.3.236.0/x86_64
export PATH=$VULKAN_SDK/bin:$PATH
export LD_LIBRARY_PATH=$VULKAN_SDK/lib${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}
export VK_LAYER_PATH=$VULKAN_SDK/etc/vulkan/explicit_layer.d