Contents



LORIOT supports a feature called SSH tunnel service.

A gateway owner can connect to their gateway from anywhere when the LORIOT Gateway Software is running.

If the error message says that gateway is disconnected then please use the restart button on the gateway dashboard to restart LORIOT Gateway Software and try the commands below again.


If the SSH Command and token isn't shown in the dashboard it either means that the feature is deactivated on your server or that you need to generate the token first.

This can be achieved in the Account dashboard in your LORIOT account, e.g https://eu1.loriot.io/account/ssh-tokens

Please note, SSH Tunnel Service is not available if using the Semtech Packet Forwader


Linux



You can find the unique command for your gateway at the gateway dashboard:

Here is an example:

ssh -o "ProxyCommand proxytunnel -v -E -p eu1.loriot.io:747 -d 555555FFFF555555.gw.eu1.loriot.io -H 'Bearer: c07f0378-6812-444b-be1e-f9eaea9876ce'" root@localhost

root is the user name on the gateway which you normally use. if it is not root then you must change it to an appropriate name. 

A typical error may be:

/bin/bash: line 0: exec: proxytunnel: not found
ssh_exchange_identification: Connection closed by remote host

To fix this, you need to install proxy tunnel package:


proxytunnel-1.9.7-cygwin.zip

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ HTML
@ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
...

To fix this just run the command sudo apt install proxytunnel which the error message recommends.


Windows


Putty version


Please copy the contents of proxytunnel-1.9.7-cygwin.zip next to putty.exe (usually c:\Program Files\putty folder)

 In Putty, go to Connection / proxy in the menu and set the following parameters:


Proxy type: Local

Proxy hostname: loriot

Port: 22

Do DNS name lookup at proxy end: Auto

Telnet Command or local proxy command: proxytunnel -v -E -p eu1.loriot.io:747 -d 555555FFFF555555.gw.eu1.loriot.io -H 'Bearer: c07f0378-6812-444b-be1e-f9eaea9876ce'


This line was copied from the example above, you need to copy this section from gateway dashboard.

Go to Session in the menu and set the following parameters:

Hostname: loriot

Port: 22

Connection type: SSH


Cygwin version

Install Cygwin from https://cygwin.com/install.html

During installation you can select packages which should be installed.

At a bare minimum you will need:

-openssh

-connect-proxy

When the installation finished, please start Cygwin terminal and read this guide's LINUX section for making a connection