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

Installing PolySync


This is the first step of the "PolySync Setup" tutorial. Here we will download and install PolySync.

Before installing PolySync you might want to look at the documents linked below. These documents are not required to install PolySync, but they are great for getting a handle on how the PolySync platform works, and may give you more insight into what is going on during installation.

The Big Picture – understand how PolySync works from a high level

Linux for Beginners – If you are not comfortable using the Linux command line, brush up on the basics here.

System Requirements

PolySync is supported on the systems defined in the supported architectures article.

Virtual environments:

  • PolySync has only been tested against Parallels (Mac) and VMWare Player 12 virtual appliances

Core dependencies are listed below. A full dependency list can be found here.

  • glib-2.0
  • meschach1.2 matrix libraries
  • gstreamer1.0 for encode/decode libraries
  • gtk2.0

Please make sure your system meets these minimum requirements.

Install PolySync

If you haven't already downloaded the PolySync Installer,you can request an installer depending on your system's architecture at the Harbrick Help Desk.

Once you have obtained the PolySync installer open a terminal and navigate to the directory where it is downloaded. Once there, you can run the installer:

$ cd ~/Downloads
$ bash polysync-release-2.0-x86_64.bin

Once the installer begins it will guide you through the necessary steps to install PolySync.



Once the installer completes you will able to run example applications, build custom applications and replay logfiles using PolySync Studio! It can take up to 15 minutes for all installation and configuration steps to complete.


  • PolySync's default install location, also known as the PolySync Home directory, is located at:/usr/local/polysync/

The installer performs a number of actions for the user: 

  • Install PolySync dependencies required to run any PolySync application
  • Update shared library file with PolySync includes and libraries for developing 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 starting PS apps

If you would like to manually install PolySync dependencies, you can find them in the polysync/README.txt file, and use the Manual PolySync Installation Guide. You can also modify the configuration script to remove any of the steps mentioned above that you do not want on your system. The file is located at: polysync/utils/

Obtain PolySync License

Follow this guide to obtain your license when you are ready.

Upgrade PolySync

Upgrading PolySync can easily be done by running a newer version of the Installer again. The installer will detect previous installations and settings for PolySync and ask if you would like to back up the previous installation ( into the /opt directory ). The installer then overwrites the installation directory with new API libraries and files.

Before upgrading PolySync, you should backup your current SDF, and any applications you have developed that are located within the /usr/local/polysync/ directory. 

Network Configuration

If you are working with a distributed system then you can follow this Network Configuration guide to prepare your system for running PolySync applications with multiple hosts. 

What's Next

You're can now start PolySync Manager and PolySync Studio and use the example application to playback pre-recorded data. You can find this tutorial here.


Have more questions? Submit a request


Please sign in to leave a comment.