Skip to content

Installing the PCoIP Software Client for Linux

To install the PCoIP Software Client for Linux:

  1. Download the Teradici repository:
    sudo wget -O teradici-repo-latest.deb https://downloads.teradici.com/ubuntu/teradici-repo-$(lsb_release -cs)-latest.deb
    
  2. Install the Teradici repository:

    sudo apt install ./teradici-repo-latest.deb
    

    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.

    Beta Software

    Users who wish to test pre-release versions of software can do so by selecting the beta distribution channel before installing. Select the beta channel, by editing editing the /etc/apt/sources.list.d/pcoip.list file and commenting the appropriate lines:

    sudo vi /etc/apt/sources.list.d/pcoip.list
    
    Teradici does not recommend installing beta software in production systems.

  3. Install the PCoIP Software Client for Linux:

    sudo apt update
    sudo apt install pcoip-client
    

  4. 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.