For general instructions on accessing services via the Desktop App, please refer here.

PuTTY is a free, open-source SSH client used to remotely access systems and servers. Since Banyan natively supports OpenSSH, you do not need to make additional configurations or changes to your machine or PuTTY client. You simply connect to the SSH server in the Banyan Desktop App, enter the server details in your PuTTY client, and securely connect to the remove server.

To access an SSH server via Banyan Desktop App and PuTTY:

  1. Launch the Banyan Desktop App, locate the SSH service, and then click Connect.
  2. Click Activate.
  3. Make note of the SSH command ((user)@(servicename)), which you'll need in the next step.
  4. Launch PuTTY. By default, the Session tab loads. Paste the (servicename) into the Host Name (or (IP address).
  5. Change the Port to 8443 and ensure the Connection type is set to SSH.
  6. Navigate to Connection > Proxy. Then, set Proxy type to Local and update Telnet command, or local host connections to banyanproxy.exe %host 8443.

    If you are using an SSH key into authenticate to the SSH server, then navigate to SSH > Auth and then upload the .pem file.

  7. Click Open.

The PuTTY client will use `banyanproxy` to automatically tunnel the SSH session over the Mutual-Auth TLS channel set up by Banyan.