How can I run Synergy 1 or Synergy 3 from the command line?

Written for Synergy 1 (v1.22.2 and v1.20.4) and Synergy 3 (v3.8.2 and v3.6.3), checked 13 October 2026.

Note: this is for more advanced users.

Running Synergy 1 or Synergy 3 from the command line is useful in enterprise environments where you want to configure the software for an end user through files.

How you run it depends on your version:

• Synergy 1 (v1.21 and later) and Synergy 3 (v3.7 and later): the core reads its settings from a settings file: Newer versions
• Synergy 1 (v1.20 and earlier) and Synergy 3 (v3.6 and earlier): every setting goes on the command line: Older versions

Requirements

1. Synergy 1 or Synergy 3 installed on each computer: Start here: Install and configure
2. Permission to run commands
3. A text config file for the server: Creating and using text config files

Newer versions: Synergy 1 (v1.21 and later) and Synergy 3 (v3.7 and later)

Write a settings file

The core (synergy-core) takes the mode on the command line and reads everything else from a settings file. Create a plain text file for each computer.

Server (replace the name and path with your own):

[core]
computerName=desk-pc

[server]
externalConfig=true
externalConfigFile=/path/to/synergy-server.conf

Client (replace the name and the server's IP address with your own):

[core]
computerName=laptop

[client]
remoteHost=192.168.1.10

Each computerName must match that computer's name in the server's config file. The connection uses port 24800 unless you add port= under [core] on both computers.

To use one network address, add interface= under [core] with that address. On the server, it's the only address the server listens on, so interface=127.0.0.1 accepts connections from the same computer only, such as through an SSH tunnel. On a client, it's the address the client connects from. Leave it out to use every address the computer has.

[core]
computerName=desk-pc
interface=192.168.1.10

It's the same setting as Network IP on the Network tab of Synergy 1's Preferences, or Network interface under Local networking in Synergy 3, which lists only the computer's network addresses. For Synergy 3's, see: Choose the network Synergy 3 uses, and keep alive

The simplest way to get every other setting right (encryption, logging) is to set the app up first, then copy its settings file to a folder of your own and edit the copy:

• Synergy 1: the settings file is Synergy.conf.
• Synergy 3: the settings file is synergy-core.conf. On the server, copy synergy.conf beside it too: that's the text config file Synergy 3 made from your layout, so point externalConfigFile at your copy. Synergy 3 rewrites both originals each time it starts the core.

They're in these folders:

Stop the app's own core

Only one core can run at a time, so stop the one the app runs first:

• Synergy 1: quit the Synergy 1 app.
• Synergy 3: click the Synergy 3 icon in the system tray (the menu bar on macOS), then choose Pause. It stays paused until you choose Resume in the same menu, which hands sharing back to Synergy 3.

Run the core

Move (cd) into the installation directory:

cd "C:\Program Files\Synergy"

cd "C:\Program Files\Synergy"

cd /Applications/Synergy.app/Contents/MacOS/

cd /Applications/Synergy.app/Contents/MacOS/

cd /usr/bin

cd /opt/Synergy

Then run the core with the path to your settings file:

synergy-core server --settings [path to settings file]

synergy-core client --settings [path to settings file]

On macOS and Linux, start each command with ./ (./synergy-core). [path to settings file] is unique to your setup, and is entered without square brackets ([]).

Command line options

Run synergy-core --help to see them. They are:

synergy-core server|client [options]

-s, --settings <file>   use this settings file
--new-instance          skip the check for a running instance
-h, --help              display help
-v, --version           display version information

The newer core has no --address, --name or other option for a single setting: those go in the settings file, such as interface= and port=. In Synergy 3, the Command arguments box on the External config page is saved but isn't passed to the core, so options typed there have no effect; use a settings file instead.

Older versions: Synergy 1 (v1.20 and earlier) and Synergy 3 (v3.6 and earlier)

Run the server and client with every setting on the command line. The programs are:

• Synergy 1: synergy-server and synergy-client. Versions older than v1.17.1 call them synergys and synergyc.
• Synergy 3: synergy-core server and synergy-core client.

Stop the app's own core

• Synergy 1: quit the Synergy 1 app.
• Synergy 3: click the Synergy 3 icon in the system tray (the menu bar on macOS), then choose Stop. Changing a setting in Synergy 3 starts its core again, so leave its settings alone while yours runs. To hand sharing back, stop your core and choose Start in the same menu.

Run the server or client

Move (cd) into the installation directory, the same as for newer versions: Run the core

Server, Synergy 1:

synergy-server -f --name [computer name] --config [path to config file]

Server, Synergy 3:

synergy-core server -f --name [computer name] --config [path to config file]

Client, Synergy 1:

synergy-client -f --name [computer name] [server IP address]

Client, Synergy 3:

synergy-core client -f --name [computer name] [server IP address]

On macOS and Linux, start each command with ./. Each [computer name] must match that computer's name in the server's config file. Enter each value without square brackets ([]).

-f keeps the server or client running in the terminal, where you can read its log. Leave it out to run it in the background.

The connection uses port 24800. To use another, add --address :[port] on the server, and put :[port] after the server's IP address on each client (192.168.1.10:24900).

Encrypt the connection with TLS

Connect each client from the app once first, so it trusts the server's certificate. Then add --enable-crypto on the server and on each client, plus:

• Synergy 1 server: nothing more; it uses the certificate the app created. To use another, add --tls-cert [path to certificate].
• Synergy 3 server: --tls-cert [path to certificate]. Synergy 3's own certificate is synergyCert.pem, in its settings folder: Write a settings file
• Synergy 3 client: --profile-dir [folder], the folder holding the servers this computer trusts: C:\ProgramData\Synergy on Windows, and its settings folder on macOS and Linux.

Command line options

Run the server or client with --help to see them all. The ones most setups use are:

-c, --config <file>      use this server config file (server only)
-n, --name <name>        use this name instead of the computer's name
-a, --address <address>  listen on this address and port (server), or
                         connect from this network interface (client)
-f, --no-daemon          run in the foreground
-d, --debug <level>      log level: FATAL, ERROR, WARNING, NOTE, INFO,
                         DEBUG, DEBUG1 or DEBUG2
-l, --log <file>         write the log to this file
--enable-crypto          encrypt the connection with TLS
--tls-cert <file>        use this TLS certificate
-h, --help               display help
--version                display version information

Control Synergy 1 or Synergy 3 from a script?

A script can write the settings file and the server's text config file, then run the core with them, as above. The config file can also bind hotkeys to actions such as switching to a computer: Creating and using text config files

Synergy 1 and Synergy 3 have no API for controlling a session while it runs. If you'd like one, tell us: Contacting our support team