Troubleshooting the background service in Synergy 3

Help & Troubleshooting

Synergy 3
Operating system:
Windows, macOS, and Linux

What is the background service?

The background service is a special process (synergy-service) in Synergy 3 that runs the auto-discovery, config-sync, and many other functions. It communicates over your LAN (local area network) between all computers which Synergy 3 is installed on.

Complete reinstall

The most reliable way to fix most issues related to the background service in Synergy 3 is to follow the guide: How to reinstall Synergy

It is very important that you follow the instructions carefully; especially the uninstall instructions for deleting config files, and also the order in which you should uninstall, reboot, then install. Rebooting after uninstalling, as well as deleting the config files on disk seems to solve most problems.

If that doesn't solve the problem, please continue reading.

Ongoing known issue

Because this is a totally new part of Synergy, there can sometimes be bugs that prevent it from starting. We appreciate the patience of our customers while we work hard to resolve these bugs.

It would help us greatly to resolve issues with the background service if you send us the .zip diagnostic report files. This gives us vital information about what's going wrong, which will help us to fix the problem.

There is currently a known ongoing issue in Synergy 3 where you'll see a background service error when starting the app. Our developers are working hard on fixing this problem, but in the meantime, here's a few things you can try.

macOS security settings

If you're using a Mac, there could be a problem with the Security & Privacy Accessibility settings. Sometimes this fails silently and provides no information about an error.

We have a help article that provides steps to resolving this: 
How to fix the macOS Security & Privacy Accessibility settings

Run the reinstall commands

The synergy-service process comes with a built-in way of reinstalling itself. This will potentially remove any invalid files, and recreate the required files that it needs to function properly.


Start the Command Prompt app (run as Administrator) and run the following:

-code- C:\Program Files\Synergy\synergy-service -u -/code-

-code- C:\Program Files\Synergy\synergy-service -i -/code-


Start the Terminal app and run the following:

-code- sudo /Applications/ -u -/code-

-code- sudo /Applications/ -i -/code-


Start the Terminal app and run the following:

-code- sudo /opt/Synergy/synergy-service -u -/code-

-code- sudo /opt/Synergy/synergy-service -i -/code-

Note: The installation path may vary depending on your flavor of Linux. In some cases if the synergy-service is running under the user session, exclude sudo from the above commands

Talk to a human

If this article didn't help, you can talk to someone on our support team (unless we sent you here, in which case please reply via the ticket you already have open).

Sorry your search terms are not showing any results