Skip to main content

pan machines

Link this machine’s dashboard to another machine over an encrypted channel and manage the links. Released in v0.73.0. Settings → Anywhere → Machines has the same actions. See Linked machines. Every verb talks to the running dashboard with this machine’s internal token, so the dashboard must be up (pan up); without one it prints the not-running message and exits 1.
Links this machine to the one that printed <pairing-url> (pan pair or Pair a device there). By default the link goes both ways at operator level.
Failures name the cause and exit 1: not a pairing link, the other machine unreachable, the pairing link expired or already used, the other machine running an Overdeck without machine links, or a machine answering with a key other than the one the link names.

list

Shows this machine, every link with its state, and the machines that hold access here.
The STATE cell carries the last incident (froze when the other dashboard stalled, network otherwise) and, for unsupported, revoked and offline, the detail. With no links: No linked machines. Link one with `pan machines link <pairing-url>` using a `pan pair` link from the other machine.
Removes the link and tells the other machine to revoke this machine’s access.
When the other machine cannot be reached it prints that it will see the link as revoked when it next connects. An unknown target prints No machine link matches "<target>" and exits 1. --json prints { ok, peerNotified }.