Yaler.net - Access your Raspberry Pi from the Web

Yaler.net

Access your Raspberry Pi from the Web

Make your Raspberry Pi accessible from anywhere via the Yaler relay.

Prerequisites

Setting up your device requires a relay domain. Please sign up to get one.

Setting up the hardware

Make sure the Raspberry Pi is connected to the Internet via Ethernet, Wi-Fi or 3G.

This tutorial is for Raspbian Jessie. Newer version? See how to access Raspbian Stretch from the Web.

Installing YalerTunnel on Raspbian

Follow these steps to install YalerTunnel on the Raspberry Pi.

Open a shell on your Raspberry Pi (default login is pi, password raspberry), or type
```
$ cd ~
```
Update apt-get with
```
$ sudo apt-get update
```

Download and install libssl and ca-certificates with

$ sudo apt-get install libssl-dev ca-certificates

Create a yalertunnel directory
```
$ mkdir yalertunnel
$ cd yalertunnel
```

Download, unzip and build the YalerTunnel source

$ wget http://s3.yaler.net/yalertunnel/YalerTunnel2-v2.3.2.src.tar.gz
$ tar xfzmv YalerTunnel2-v2.3.2.src.tar.gz
$ make

To check the installation, display the YalerTunnel version and usage with
```
$ ./yalertunnel
```
Done. Now either enable Web access or SSH access or VNC access.

Web access

Prerequisites

A Web server or service has been installed and is running on the Raspberry Pi.

Enabling Web access on Raspbian

How to configure YalerTunnel on your Raspberry Pi to make a local Web service accessible from anywhere.

Download and install runit with
```
$ sudo apt-get install runit
```

Create a yalertunnel service directory

$ sudo mkdir /etc/service/yalertunnel
$ cd /etc/service/yalertunnel

Download the yalertunnel run script and make it executable

$ sudo wget http://s3.yaler.net/raspi/run
$ sudo chmod a+x run

Download the yalertunnel finish script and make it executable

$ sudo wget http://s3.yaler.net/raspi/finish
$ sudo chmod a+x finish

Open the run script with
```
$ sudo nano /etc/service/yalertunnel/run
```
Check the path (default: /home/pi/yalertunnel), set the port of the local Web service (default: 80), and set your relay domain
```
1 #!/bin/sh
⋮
6 exec /home/pi/yalertunnel/yalertunnel server 127.0.0.1:80 try.yaler.io:80 RELAY_DOMAIN -min-listeners 1 </dev/null 2>&1 | logger -t yalertunnel
```
Save changes with CTRL-X, then Y, then RETURN. Do not change the local IP (default: 127.0.0.1), unless the Web service runs on a separate device in the same network.
Reboot your Raspberry Pi to run the script
```
$ sudo reboot
```
Done. Now access your device from any Web browser or with Curl or from iOS or from Android (and resolve errors).

Disabling Web access on Raspbian

How to remove YalerTunnel to disable Web access from anywhere.

Open a shell on your Raspberry Pi and type

$ sudo sv stop yalertunnel
$ sudo rm -r /etc/service/yalertunnel
$ sudo reboot

SSH access

Prerequisites

The SSH daemon sshd is running on the Raspberry Pi.

To enable sshd on Raspbian, add a file called ssh to the boot partition of the SD card or use raspi-config.

Enabling SSH access on Raspbian

How to configure YalerTunnel on your Raspberry Pi to allow SSH access from anywhere.

Download and install runit with
```
$ sudo apt-get install runit
```

Create a yalertunnel-ssh service directory

$ sudo mkdir /etc/service/yalertunnel-ssh
$ cd /etc/service/yalertunnel-ssh

Download the yalertunnel run script and make it executable

$ sudo wget http://s3.yaler.net/raspi/run-ssh -O run
$ sudo chmod a+x run

Download the yalertunnel finish script and make it executable

$ sudo wget http://s3.yaler.net/raspi/finish
$ sudo chmod a+x finish

Open the run script with
```
$ sudo nano /etc/service/yalertunnel-ssh/run
```
Check the path (default: /home/pi/yalertunnel), set the port of the local SSH service (default: 22), and set your relay domain
```
1 #!/bin/sh
⋮
6 exec /home/pi/yalertunnel/yalertunnel proxy 127.0.0.1:22 try.yaler.io:80 RELAY_DOMAIN </dev/null 2>&1 | logger -t yalertunnel-ssh
```
Save changes with CTRL-X, then Y, then RETURN. Do not change the local IP (default: 127.0.0.1), unless the SSH service runs on a separate device in the same network.
Reboot your Raspberry Pi to run the script
```
$ sudo reboot
```
Done. Now access your device with Putty or with SSH (for Linux, Mac OS X).

Disabling SSH access on Raspbian

How to remove YalerTunnel to disable SSH access from anywhere.

Open a shell on your Raspberry Pi and type

$ sudo sv stop yalertunnel-ssh
$ sudo rm -r /etc/service/yalertunnel-ssh
$ sudo reboot

VNC access

Prerequisites

A VNC service has been installed and is running on the Raspberry Pi.

Enabling VNC access on Raspbian

How to configure YalerTunnel on your Raspberry Pi to allow VNC access from anywhere.

Download and install runit with
```
$ sudo apt-get install runit
```

Create a yalertunnel-vnc service directory

$ sudo mkdir /etc/service/yalertunnel-vnc
$ cd /etc/service/yalertunnel-vnc

Download the yalertunnel run script and make it executable

$ sudo wget http://s3.yaler.net/raspi/run-vnc -O run
$ sudo chmod a+x run

Download the yalertunnel finish script and make it executable

$ sudo wget http://s3.yaler.net/raspi/finish
$ sudo chmod a+x finish

Open the run script with
```
$ sudo nano /etc/service/yalertunnel-vnc/run
```
Check the path (default: /home/pi/yalertunnel), set the port of the local VNC service (default: 5901), and set your relay domain
```
1 #!/bin/sh
⋮
6 exec /home/pi/yalertunnel/yalertunnel proxy 127.0.0.1:5901 try.yaler.io:80 RELAY_DOMAIN </dev/null 2>&1 | logger -t yalertunnel-vnc
```
Save changes with CTRL-X, then Y, then RETURN. Do not change the local IP (default: 127.0.0.1), unless the VNC service runs on a separate device in the same network.
Reboot your Raspberry Pi to run the script
```
$ sudo reboot
```
Done. Now, see how to access your device with VNC.

Disabling VNC access on Raspbian

How to remove YalerTunnel to disable VNC access from anywhere.

Open a shell on your Raspberry Pi and type

$ sudo sv stop yalertunnel-vnc
$ sudo rm -r /etc/service/yalertunnel-vnc
$ sudo reboot

Troubleshooting

How to fix common issues.

To make sure the YalerTunnel daemon was installed correctly, type
```
$ ~/yalertunnel/yalertunnel
```
To see if the YalerTunnel service is up and running, type
```
$ ps aux | grep [y]aler
```

To display the YalerTunnel service log, type

$ greplog () {
   cd /var/log
   {
       cat $1 $1.*[0-9]
       zcat $1.*.gz
   } | grep "$2"
}
$ greplog messages yalertunnel

To debug DNS issues, type

$ cd ~/yalertunnel/udns
$ make dnsget
$ ./dnsget -o udpbuf:512 -vv try.yaler.io

and

$ host -v try.yaler.io

If an issue persists, get help.

To enable Web and SSH or VNC access at the same time, or tunnel another protocol, please get in touch.

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