Skip to content

Installing GPU Drivers on Linux machines

Before installing the PCoIP Agent, install the correct driver for your configured GPUs. SSH into your machine and then proceed with the installation instructions below.

The correct driver versions for release 23.04 are shown below. Be sure to install the specified driver, and not the latest available version. We qualify Graphics Agent support against the driver versions listed here.

Documentation for download and installation of these drivers is provided by their manufacturers. As a convenience, we've provided the current locations of relevant third-party documentation here. While we do our best to keep these links up to date, we do not control these resources or their locations and it's possible that they could break.

Install NVIDIA GRID Drivers on AWS Instances

Instance Type Supported GPUs Supported NVIDIA GRID driver version Installation instructions
EC2 G4dn NVIDIA T4 GRID 15.1 (525.85.05)+ Download the driver from Amazon using the AWS CLI or SDKs, as documented by Amazon.
G4 instances must also include NVIDIA licensing, as documented by NVIDIA.
EC2 G5 NVIDIA A10G GRID 15.1 (525.85.05)+ Download the driver from Amazon using the AWS CLI or SDKs, as documented by Amazon.
G5 instances must also include NVIDIA licensing, as documented by NVIDIA.

Install NVIDIA Drivers on Physical PCs

Instance Type Supported GPUs Supported NVIDIA driver version Installation instructions
Physical PC
  • Tesla (any)
  • Quadro (k2000+)
Use the latest 450+ driver for your supported GPU Download the driver directly from NVIDIA and follow their instructions to install. You may only have access to this driver if you have purchased a corresponding card.

Install NVIDIA GRID Drivers on Azure NV-series Instances

Instance Type Supported GPUs Supported NVIDIA GRID driver version Installation instructions
Azure NV-series NVIDIA M60, T4 GRID 15.1 (525.85.05)+ Microsoft Azure download

Install NVIDIA GRID Drivers on Google Cloud Instances

Instance Type Supported GPUs Supported NVIDIA GRID driver version Installation instructions
Google Cloud instances NVIDIA P4, P100, T4 GRID 15.1 (525.85.05)+ Google Cloud Documentation

Install NVIDIA GRID Drivers on Other Instance Types

Instance Type Supported GPUs Supported NVIDIA GRID driver version Installation instructions
All other instance types GPUs as listed in NVIDIA's GRID release notes. GRID 15.1 (525.85.05)+ Instructions shown below.

To install NVIDIA driver for all other instances, including non-cloud instances:

  1. Install tools required to install the NVIDIA drivers:

    sudo apt install build-essential
    
  2. Disable the Nouveau video driver (two commands):

    echo 'blacklist nouveau' | sudo tee -a /etc/modprobe.d/blacklist.conf
    

  3. As a super user (sudo), edit the file /etc/default/grub. Append the following to the GRUB_CMDLINE_LINUX entry:

    rd.driver.blacklist=nouveau nouveau.modeset=0
    

    For example:

    GRUB_CMDLINE_LINUX="crashkernel=auto console=ttyS0,38400n8 rd.driver.blacklist=nouveau nouveau.modeset=0"
    

    Generate a new grub configuration to include the above changes, then reboot:

    sudo grub2-mkconfig -o /boot/grub2/grub.cfg 
    sudo reboot
    
  4. Install the NVIDIA driver:

    sudo ./NVIDIA-Linux-x86_64-xxx.xx-grid.run
    

    Where xxx.xx is the NVIDIA driver version shown in Linux System Requirements.

  5. Respond to the installer prompts as follows:

    • Accept the EULA
    • Say yes to installing 32-bit binaries
    • Say no to modifying the x.org file
  6. Verify the NVIDIA installation:

    nvidia-smi
    

    If the installation was successful, you will see your video card in the response.

Installing the PCoIP Agent

Once the NVIDIA drivers are present, you can install the Graphics Agent for Linux.