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.

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 PCoIP 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_max: A kernel parameter that controls the maximum size of receive buffers used by sockets.
  • rmem_default: A kernel parameter that controls the default size of receive buffers used by sockets.
  • 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.

rmem_max size

This parameter must be at least as large as rmem_default/

The values of these parameters can be viewed on the command line when the script is run, as outlined in the example below:

# cat /etc/sysctl.d/01-pcoip-client.conf
net.core.rmem_max = 32000000
net.core.rmem_default = 32000000
net.ipv4.udp_mem = 1000000 2000000 4000000
net.core.netdev_max_backlog = 2000

Troubleshooting PCoIP Session Connection Issues

If you encounter issues with your PCoIP Session, please see the following KB article: https://help.teradici.com/s/article/1027. This article details some potential causes and fixes for common connection issues.

Installing the Software Client in Silent Mode

The following section outlines how to install the PCoIP Software Client in silent mode. Please note that you must authorize the application to run in silent mode. The following commands outline how to install the PCoIP Software Client on Ubuntu in silent mode:

  • Ubuntu Client: 
    sudo apt install -y <pcoip-client deb package>