---

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.

• To make sure YalerTunnel was built correctly, type

  $ java YalerTunnel

• If javac command not found or java could not find main class download the compiled YalerTunnel.class and try again.
• If downloading the class file does not fix the issue, check your PATH or install JDK or JRE.
• If an issue persists, get help.

---

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