Network
The flags and environment variables that set these are in the CLI reference. A server shared with other people is set up in Run a Shared Server.
| Port | Protocol | Use | Set with |
|---|---|---|---|
5555 | TCP, WebSocket (ws://, no TLS) | Clients: VSCode, terminal views | --server-port; VSCode: resonon.server.port |
5556 | UDP multicast, group 239.255.82.78 | Discovery beacon | Fixed |
The server binds 0.0.0.0 — every interface — unless --server-host names one address, such as
127.0.0.1 for this machine only. When it is ready it prints:
[server] Listening on 0.0.0.0:5555The language server opens no port; it talks to VSCode over stdio.
Discovery
Section titled “Discovery”| Fact | Value |
|---|---|
| Sent | Once a second, on the loopback interface: only views and editors on the same machine receive it |
| Content | JSON: service ("resonon"), ws_port, name, password_required |
name | --server-name, or the machine’s host name |
| Listeners | The terminal views’ connect screen and VSCode’s Servers view, on loopback and the default interface |
| Removed from the list | 6 s after the last beacon in a terminal view; 4 s in VSCode, for a server not connected |
A server that discovery does not reach is added by address: Add Server… in VSCode, the address
field of the connect screen, or --host and --port.
Password
Section titled “Password”| Fact | Value |
|---|---|
| Set with | --password, or RESONON_SERVER_PASSWORD, which wins over the flag |
| Without one | Every client that connects is accepted |
| Wrong or missing | The client is told Invalid password and disconnected |
| Sent | In clear text, as the first message after connecting |
Connection
Section titled “Connection”The server pings every client every 30 seconds. VSCode tries to reconnect 3 times after the connection drops; a terminal view returns to its connect screen.