SL SSH-LINK

Configuration reference

Agent parameters and YAML

The Agent accepts YAML, command-line parameters, and interactive input. Command-line parameters override YAML values.

What this page is for: Look up Agent configuration sources, command-line parameters, YAML examples, and the small server configuration used by the relay.

Configuration lookup order

  1. --config PATH or the CONFIG environment variable.
  2. agent.yaml beside the executable.
  3. ssh-link-agent.yaml or config.yaml beside the executable.
  4. Interactive prompt when required values are missing.

Useful command-line parameters

--server-url relay.kvasetech.com
--agent-id WINDOWS-PC
--secret AGENT_SECRET
--service-name ssh-local
--service-host 127.0.0.1
--service-port 22
--service ssh-local=127.0.0.1:22

Agent YAML

server_url: https://relay.kvasetech.com
agent_id: windows-office-pc
attach_secret: replace-with-agent-secret
services:
  - name: ssh-local
    host: 127.0.0.1
    port: 22

Server example

The relay does not need manager tokens or predefined agents. The Agent registers dynamically, and the Manager must know that Agent's attach secret to open a session.

Server YAML example