How to reinstall Synergy 1

Reinstalling is one of the first basic steps you can take when experiencing problems with configuring Synergy. Sometimes, there might be a file in the installation that has become corrupt or invalid. Reinstalling is often a simple way to resolve this issue.

Windows

1. Uninstall Synergy using “Add or remove programs” (or Apps & features).
2. Click uninstall. You will see a message saying “This app and its related info will be uninstalled”. Click “Uninstall” again. 
3. The message on display will then say that the app will need to be closed, and you will be asked if you want the app to automatically close, select this option and follow the steps. It should take less than one minute to uninstall. 
4. Run regedit and delete these registry keys (if they exist):

• HKEY_CURRENT_USER\Software\Symless
• HKEY_CURRENT_USER\Software\Synergy
• HKEY_LOCAL_MACHINE\SOFTWARE\Synergy

5. Delete these directories (if they exist):

• C:\ProgramData\Symless
• C:\ProgramData\Synergy v2
• %USERPROFILE%\AppData\Local\Synergy
• %USERPROFILE%\AppData\Local\Symless

6. Delete config folder SystemConfig.ini (In case used "All users" settings)
   Location example:
   C:\Program Files\Synergy\SystemConfig.ini
   Note: In this case, you will lose previously saved settings.
7. Reboot Windows to ensure that the hook DLL is completely unloaded.
8. Install Synergy as you would normally.
9. If you see the error "The feature you are trying to use is on a network resource that is unavailable", then try the Microsoft MSI troubleshooter

macOS

1. Close the Synergy app if it's running.
2. Delete the Synergy app from the Applications directory.
3. Run these commands to remove the settings (don't worry if the files or dirs don't exist).

-code- rm -rf ~/Library/Preferences/Synergy-/code-

-code-rm -rf ~/Library/Preferences/Symless -/code-

-code-rm -rf ~/Library/Synergy-/code-

-code-rm -rf ~/Library/Symless-/code-

-code-rm ~/Library/Preferences/com.https-symless-com.Synergy.plist-/code-

-code-rm ~/Library/Preferences/com.http-symless-com.Synergy.plist-/code-

4. Run this command to unload the preferences:

-code-killall -u $USER cfprefsd-/code-

5. Delete config folder SystemConfig.ini (In case used "All users" settings)
   Location example:
   usr/local/etc/Symless/SystemConfig.ini
   Note: In this case, you will lose previously saved settings.
6. Install as you would normally. Sometimes the cfprefsd command fails silently, so you may need to retry the reinstall steps.

Linux

1. Remove the Synergy package using your package manager.
2. Run these commands to remove your settings (don't worry if the dirs doesn't exist):

-code-rm -rf ~/.config/Symless/-/code-

-code-rm -rf ~/.config/Synergy/-/code-

-code-rm -rf ~/.synergy/-/code-

-code-rm -rf ~/.symless/-/code-
‍

3. Delete config folder SystemConfig.ini (In case used "All users" settings)
   Location example:
   usr/local/etc/Symless/SystemConfig.ini
   Note: In this case, you will lose previously saved settings.
4. Install as you would normally.