Installation and First Run

System requirements

Requirements Details
Operating system: Any up-to-date Linux distribution.
Remote desktop clients: FreeRDP, Amazon WorkSpaces client, Amazon DCV client, Citrix Workspace app, Omnissa Horizon Client, HP Anyware PCoIP Client.

Downloading packages

To install Serial Port for Remote Desktop (Linux version) Workstation, download two packages (FT Plugins package and product installation package) corresponding to your OS and architecture:

  • For Debian-based Linux distributions (e.g., Ubuntu, Debian, Mint), download .deb packages.
  • For other Linux distributions, select .tar.gz archives.

The latest program version is available at www.serial-port-redirector.com.

Installing from .deb Package

Simply install both downloaded packages with your preferred package manager or from the terminal by executing the following command:

$ sudo apt-get install ./ftplugins-*.deb ./ftspr-*.deb
Alternatively, you can use dpkg:
$ sudo dpkg -i ftplugins-*.deb ftspr-*.deb

If installed separately, FT Plugins must be installed first, otherwise the product installation may fail due to missing dependencies.

Installing from .tar.gz archive

Unpack archives to the /opt:

$ sudo tar -zxf ftplugins-*.tar.gz -C /opt
$ sudo tar -zxf ftspr-*.tar.gz -C /opt

Automated setup

To run the automated setup script your OS must have systemd, which most modern Linux distributions include.

Run the setup script with -i or --install option and it will do the rest:

$ sudo /opt/ftspr/bin/ftspr-setup.sh -i

Manual setup

Alternatively, you can start the daemon manually. In some distributions of Linux you need administrator rights for correct daemon functioning. You must run it as a root:

$ sudo /opt/ftspr/sbin/ftsprd

or:

$ su -c "/opt/ftspr/sbin/ftsprd"

Now you can use serial ports in remote desktop session. To see the list of all supported options, run:

$ /opt/ftspr/sbin/ftsprd -h

Daemon management can be done with a configuration file.