Skip to main content

Tunnel Client for Devices

Download the Client

  1. Open a session (Manual or Automation) on a device.
  2. Click Network Tunneling.
  3. Click Download.  The client executable is downloaded to your machine.

Operating the Client

Start the client in a shell (on Mac or Linux) or CMD window (on Windows), with the --url and --access-key flags indicating which cloud and which user or project is connecting.

For your convenience, the full command line (using your current credentials on the Cloud you connected to) is displayed in the dialog, and you can simply copy/paste it into your terminal.

03-istpc-started-mac-Screen Shot 2018-09-04 at 11.02.45

info
  • Before the first run, make sure the downloaded file is executable (eg, run chmod +x network-tunnel)
  • In most shells, to start the client in the local folder, prepend ./ to the command (eg, ./network-tunnel ...)

A connected client is necessary but not sufficient for a tunnel to actually be created. A session can be tunneled when the device is on a properly configured Agent with a connected Tunneling Server.

For as long as your session is tunneled, you see a red dot on Tools icon and Tunneling icon is set to active (green colored icon):