Never Ending Security

It starts all here

How to Configure Synergy on Linux

How to Configure Synergy on Linux

UPDATE: Synergy (GPL input sharing software) gone paid. We publish only free and opensource reviews and tools and we are currently looking for the best solution to replace this review.

Synergy is an open source network utility which can be used to share one keyboard and mouse with multiple systems.

Synergy utility works on client-server model. The system whose keyboard and mouse you want to share, runs the synergy server service (synergys), and all the other systems runs the synergy client service (synergyc) to connect to server.

Synergy is a platform independent utility. Compiled version of synergy is available for various platforms including Windows, Linux, Mac OS X, Android and Apple iOS. You can download source code and compiled version from here.

Synergy brings your devices together in one cohesive experience.

  • Seamlessly move your mouse to any computer and start typing.
  • Works on all major operating systems (Windows, Mac OS X, and Linux).
  • Share your clipboard (copy and paste) between your computers.
  • Drag and drop files from one computer to another (Premium).
  • Encryption keeps sensitive data safe on public networks.
  • Network-based (IP) software KVM switch (non-video)

Use the appropriate package management command to install Synergy on your system as shown below. For Windows, you can directly download executable and install it.

# For Mac OSX :
sudo port install synergy

# For Fedora, CentOs and RHEL :
sudo yum install synergy

# For Ubuntu, LinuxMint and Debian :
sudo apt-get install synergy

Example Synergy Configuration Setup

In this case, we will have three systems mac-dev, nix-dev and fed-dev all connected to local network.


After installation, you need to define a configuration file to run synergy.

Configuration file has information about how these systems are connected in X,Y Plane. The synergy configuration file has the following sections:

  1. screens
  2. links
  3. aliases
  4. options

The default syntax of all sections is shown below. Just replace the name to one of the above section name.

section: name

Screens Section

Screens section will specify how many systems are going to connect through synergy service.

In screens section, either you can use either ip address or hostname of the systems.

section: screens

Links Section

Links section will specify how these systems are going to connect in X,Y Plane.

There are four options such as left, right, down and up to connect screens to each other. Before writing link section, keep the system on which you want to run synergy server service ( it means you want to use keyboard and mouse of the system in all systems which are connected across local network.

section: links
left = mac-dev
right =
right = nix-dev

Aliases Section

In aliases section, you could write alias for domain name to use short name in screens and links sections.

section: aliases

Options Section

In options section, there are list of arguments which can be use to modify uses of synergy service in configuration. You can get full list of options from synergy website.

section: options
keystroke(alt+left) = switchInDirection(left)

Start Synergy Service

For minimum configuration, you need at least two options such as screens and links.

In the system which has keyboard and mouse, you need to start synergy server service as shown below, which will wait for all client to connect according to configuration file.

synergys -f -c mysynergy.conf

-f flags : To run synergy server service in foreground, by default it runs in the background
-c flags : to pass configuration file to synergy server service

For other connected systems, start synergy client service with server hostname or server ip address on which synergy server service is running as shown below.

synergyc -f nix-dev


synergyc -f

-f flags : to run synergy server service in foreground

Debugging Synergy Issues

The following “failed to connect to server” is a common synergy service error message.

WARNING: failed to connect to server:
NOTE: connecting to ’nix-dev’:

In most case, the above error message is because of the firewall not allowing the client to talk to the server. Modify the iptables rules accordingly to allow port 24800.

If you have’ve installed different version of synergy client and server, you might get the following message. In this case, make sure to install the same version on both server and all the clients.

WARNING: failed to connect to server: incompatible client 1.4
NOTE: connecting to ’nix-dev’:

More information can be found at:

Leave a Reply

Please log in using one of these methods to post your comment: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s