Several machines

What you need. harnsy Max on the master. A member borrows harnsy Max from the master without a key of its own (the master lends it to as many members as its seats minus one). The free harnsy has no machines.

The easy way (0.11.0).

1. On the master, open Settings › Machines and press “+ Connect a machine”.

2. Choose the system (Linux or macOS, or Windows). If the other machine has to reach this one directly, fill in this PC’s address; behind the relay you leave it empty.

3. Press “Get the command”. The window shows ONE command. Run it on the other machine. It installs harnsy there too, and works once and for one hour. The command looks like this:

curl -fsSL https://harnsy.dev/install.sh | HARNSY_JOIN='<address>#<ticket>' sh

$env:HARNSY_JOIN='<address>#<ticket>'; irm https://harnsy.dev/install.ps1 | iex

You see: “Waiting for the machine…” and then that the machine is connected. Unused commands are listed with “Revoke”.

The older way (0.10.0, still works). On the master issue a token; the command prints the join line:

harnsy debug cluster issue <name>

On the member run:

harnsy debug cluster init <name> --join <master url> --token <token>

The relay (beta). If the master has no public address, a member can reach it through the harnsy relay. Both dial out to the relay, which only joins encrypted streams: the connection between master and member is encrypted and pinned to the master’s certificate, so, by design, the relay joins encrypted streams and does not read them. The relay is a beta in this release: its address and limits may still change. It needs harnsy Max and an activated licence on the master. On the master turn it on, then restart harnsy:

harnsy cluster relay on

To stop it:

harnsy cluster relay off

Settings › Machines shows whether the relay is up. You can run a relay of your own on a server with a public address; that needs a licence with the relay-host right:

harnsy relay serve --addr :443 --domain <name>

What the master sees. A master sees a member’s terminals only if the member allows it: Settings › Machines on the member, “Let the master connect to this node’s terminals”: No, View, or View and type.