Skip to content

Installing the PCoIP Remote Workstation Card Agent for Linux on RHEL or CentOS

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.

Before proceeding with Remote Workstation Card Agent for Linux installation, install a desktop environment. To install a desktop environment in RHEL or CentOS, use the following command:

sudo yum groupinstall 'Server with GUI'

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.

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

  • If you are using a 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 PCoIP Agent.

  3. If required, configure the agent software.

  4. Disconnect the SSH session.

  5. 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 install the Remote Workstation Card Agent for Linux.