Help

Jump hosts

A host behind a bastion is reached the way OpenSSH reaches it, with ProxyJump. The terminal, the host's files, its monitor and its tunnels all go through the jump host on one connection, so you log in once.

A host you add in Wayfinder

  1. Add the jump host itself with File › New Host… (⌘N) and check that it connects.
  2. Add the host behind it. Its address is the one the jump host uses to reach it, such as 10.0.4.31.
  3. In Jump host, pick the bastion from the list, or type it as user@bastion.example.com:2222.

For more than one jump, list them in order, separated by commas: ops@bastion.example.com,10.0.4.1. The host is saved with a ProxyJump line, so ssh in any terminal can use it too once you choose Use These Hosts in Every Terminal in Settings › Connections.

A host in your own ssh_config

Write ProxyJump there as usual. Wayfinder reads the file as it is, so there is nothing to set in the app:

Host app-behind
  HostName 10.0.4.31
  User deploy
  ProxyJump ops@bastion.example.com

Since Wayfinder runs the Mac's own OpenSSH, an older ProxyCommand line works too.

When it does not connect

Next: Keys and SSH agents