Skip to main content
Handshake uses localhost:8765 by default.

​
Automatic port selection

When you run handshake setup, Handshake checks the configured port. If another process uses the port, setup checks as many as 100 consecutive ports and selects the first available port. If an active Handshake daemon uses the port, setup reuses that daemon address.

​
Set a specified port

1

Set the address

Run:
2

Run setup

Run:
Setup updates the service definition, hooks, plugins, and MCP registrations.
3

Restart open agents

Close and restart each connected agent.
4

Check the new port

Run:
The response must be ok.
Do not set a non-loopback address. Handshake refuses the address to protect local session data.