Dear Customers,

The PolySync Support Center is now just for submitting tickets to our support team. All articles and tutorials have been moved to the new PolySync Help Center and the content below will be removed shortly.

Thank you,
The PolySync Team

Manual install of PolySync

This article will guide you through the manual installation of any version of PolySync using a command line interface.

PolySync provides the bash scripts to perform the installation process. You are encouraged to view these scripts and understand the required configurations for each PolySync host. Following all steps detailed will ensure your system runs as smooth as possible.

Remove the Previous Installation

For those who already have PolySync installed, it's important that any previous version of PolySync is removed before continuing. Create a backup of the existing install, and remove the existing instance of PSYNC_HOME.

$ echo $PSYC_HOME
$ tar cfz /opt/polysync-date-backup.tar.gz /usr/local/polysync 
$ rm -rf /usr/local/polysync

Install PolySync

After obtaining a PolySync release package from the Support Center, download and extract the archive.

$ cd ~/Downloads/
$ tar xf polysync-release-2.0.0-x86_64.tar.gz

Next copy (or move) the polysync/ directory to the desired location. The default location is /usr/local. Next you need to export the PSYNC_HOME environment variable.

$ mv polysync/ /usr/local
$ export PSYNC_HOME=/usr/local/polysync


You will need to install a handful of software dependencies before PolySync can be installed and run properly.

$ sudo ./utils/

You can find the full list of PolySync dependencies in the polysync/README.txt file.


The following steps are performed by the script.

  • Update shared library file with PolySync includes and libraries for developing and running PolySync applications
  • Append the PolySync environment script to the global bashrc file to place binaries within the shell's path
  • Update udev rules specifically for the Xsens MTi-G USB interface
  • Change permissions for PolySync home directory (/usr/local/polysync/)
  • Install Kvaser linuxcan drivers for current kernel to enable CAN communication with USB and PCI hardware
  • Install Flycapture package required for PointGrey GigE cameras
  • Set up PolySync Studio Ubuntu Icon for quick start

You can start the script by passing in two arguments. Call the license tool after the post-installation script to download an existing license from the server.

  • Installation directory
    • This must match the directory 'polysync/' was moved to in the Install PolySync step above
  • Username
    • Must provide username for the account who will own the polysync directory and have permissions to access
$ sudo ./utils/ /usr/local/polysync dev

Downloading the License

For a new installation of PolySync, you will need an activation ID which represents your PolySync license. You can activate the license with the following:

$ polysync-license-tool -a xxxx-xxxx-xxxx-xxxx-xxxx 

For machines with an existing license, you can use the license tool without an activation ID:

$ polysync-license-tool -a



Have more questions? Submit a request


Please sign in to leave a comment.