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:
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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