Skip to content

Installing the PCoIP Software Client for Linux

To install the PCoIP Software Client for Linux:

  1. Install the Software Client for Linux repository. A shell script to install this is here.

    Teradici Distribution Platform

    Teradici's distribution platform has recently changed. The new system requires access to the dl.teradici.com subdomain. The old system, which used downloads.teradici.com, is deprecated and will be decommissioned in the future.

    teradici-repo Package

    If you do not install the teradici-repo package then you will not be able to successfully install the PCoIP Software Client. You may be experiencing this issue if you see an error message stating Unable to locate pcoip-client. Please ensure you download and install the repo.

  2. Install the PCoIP Software Client for Linux:

    sudo apt update
    sudo apt install pcoip-client
    

  3. Launch the pcoip-client to create default configuration files and then quit the client.

It is also possible to install and run the PCoIP Software Client for Linux within a docker container, for information on this process, see Docker Containers.

The reference section also has information on Disabling the Virtual Terminal Functionality and configuring Linux Keyboard Shortcuts.

Kernel Network Configuration

The pcoip-configure-kernel-networking.sh script is installed with the Software Client for Linux. This script tunes the kernel networking configuration to facilitate the network performance required by the Client. You need to run this script after installing the PCoIP Software Client for Linux.

Run the following command:

$ sudo pcoip-configure-kernel-networking --persistent
The script contains the following parameters:

  • rmem_default: A kernel parameter that controls the default size of receive buffers used by sockets.
  • rmem_max: A kernel parameter that controls the maximum size of receive buffers used by sockets.

rmem_max size

This parameter must be at least as large as rmem_default/

  • ipv4.udp_mem: A kernel parameter that controls the maximum total buffer-space to allocate.
  • netdev_max_backlog: A kernel parameter that controls the maximum size of the receive queue.