Access your device with VNC

From anywhere, via the Yaler relay.

Prerequisites

A device running a VNC service. To set up your device, see getting started.

This tutorial is in beta. Found a bug? Let us know.

Building YalerTunnel on Linux, Mac OS X or Windows

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

  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. Now use a VNC viewer on Linux or Mac OS X or Windows

Linux

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

  1. To start YalerTunnel on your computer, using your relay domain (e.g. gsiot-ffmq-ttd5), type
    $ java YalerTunnel client 127.0.0.1:5901 try.yaler.io:80 RELAY_DOMAIN
  2. Then start Remote Desktop, set Protocol to VNC - Virtual Network Computing and Server to 127.0.0.1:5901 and click Connect.

  3. Done. You should now see the login prompt.


Mac OS X

Using YalerTunnel and VNC on Mac OS X

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

  1. On your client computer, to create an alias for lo0, type
    $ sudo ifconfig lo0 alias 127.0.0.2
  2. Then, to start YalerTunnel in client mode, using your relay domain (e.g. gsiot-ffmq-ttd5), type
    $ java YalerTunnel client 127.0.0.2:5900 try.yaler.io:80 RELAY_DOMAIN
  3. In a second shell, on the client computer, access your device via the local YalerTunnel with vnc
    $ open vnc://127.0.0.2
  4. Done. You should now see the login prompt. After the session, to remove the alias for lo0 again, type
    $ sudo ifconfig lo0 -alias 127.0.0.2

Troubleshooting on Mac OS X

How to fix common issues.


Windows

Installing TightVNC on Windows

Download and install TightVNC from http://www.tightvnc.com/download.php

Using YalerTunnel and TightVNC on Windows

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

  1. To start YalerTunnel on your computer, using your relay domain (e.g. gsiot-ffmq-ttd5), type
    $ java YalerTunnel client 127.0.0.1:5901 try.yaler.io:80 RELAY_DOMAIN
  2. Then start TightVNC, set Remote Host to 127.0.0.1:5901, and click Connect.

  3. Done. You should now see the login prompt.


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