Skip to content

Installing the PCoIP Graphics Agent for Linux on Ubuntu

Before you proceed with installation, a few prerequisites must be met.


These instructions assume you have already built the remote desktop machine, and that the machine meets the agent's requirements.

Important: A desktop environment is required

Before proceeding, install a desktop environment of your choice. Kubuntu distributions are bundled with KDE; you can install KDE from other distributions by using this command:

sudo apt install kubuntu-desktop

To install Mate Desktop, use this command:

sudo apt install ubuntu-mate-desktop

These commands are provided as a convenience; there is no requirement for KDE or Mate Desktop. Any desktop environment will work.

The Graphics Agent for Linux has additional requirements for GPU acceleration. Make sure your machine is configured with a supported card before you start (we'll install the correct driver as part of this process).

A few other things to confirm before proceeding:

  • SSH must be enabled.

  • You must have a license registration code for the agent instance from Teradici (as part of a Teradici Cloud Access subscription).

  • The desktop machine requires the following ports to be open: TCP 443, TCP 60443, TCP 4172, and UDP 4172.

  • Your GPUs must be licensed with their manufacturers (if required).

  • You must have super user (root) privileges and be able to issue sudo commands.

  • If you are using a PCoIP Local License Server, PCoIP Local License Server, you'll need to know it's URL and port numbers.

Important: Protect your license registration code

The license registration code you receive from Teradici is unique to your organization, and should be protected as you would any sensitive data.

Be careful that you do not inadvertently expose your registration code in forums or other public areas by pasting log messages without redacting sensitive information.

Installation Overview

Once your prerequisites are in place, you can proceed with installation. Here's a brief overview of the process:

  1. Connect to the machine using SSH.

  2. Install the appropriate GPU drivers for your system.

  3. Install the PCoIP Agent on a PCoIP Agent.

  4. If required, configure the agent software.

  5. Disconnect the SSH session.

  6. Connect to the desktop using a PCoIP client.

If you're ready to start, connect to your machine with an SSH client and proceed to Installing GPU Drivers.