Access your device with SSH

From anywhere, via the Yaler relay.

Prerequisites

A device running an SSH service. To set up your device, see getting started.

This tutorial is for Linux and Mac OS X. On Windows, access your device with Putty. Or access your device from Android.

Building YalerTunnel on Linux and Mac OS X

How to build YalerTunnel on the client computer in order to enable tunneling SSH.

  1. Make sure JDK6 (or later) is installed and your PATH environment variable contains the JDK's bin directory.
  2. Download and unzip the YalerTunnel Java source
    YalerTunnel.src.zip
  3. To build YalerTunnel, open a shell, go to the unzipped directory, and type
    $ javac YalerTunnel.java
  4. Done.

Using YalerTunnel and SSH on Linux and Mac OS X

How to run YalerTunnel on the client computer to enable SSH access to your device.

  1. To start YalerTunnel on a client computer, using your relay domain (e.g. gsiot-ffmq-ttd5), type
    $ java YalerTunnel client 127.0.0.1:10022 try.yaler.io:80 RELAY_DOMAIN
  2. In a second shell, on the same client computer, using the remote login, access your device via the local YalerTunnel
    $ ssh root@localhost -p 10022 -o ServerAliveInterval=5
  3. Done.


Troubleshooting

How to fix common issues.


Creative Commons License This work by Yaler GmbH is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.