Installing remoteit on OpenWrt



Please note that this section describes a software package which has been superseded. We do not recommend the use of remoteit 3.x for new designs.  For instructions on downloading and installing the most recent device package, please follow this link.

Connect to your Device

In this example we will be using the GL-iNet GL-MT300N-V2 mini router.  The procedure should be similar for other OpenWrt based devices as well.

Connect the router's WAN port to an active internet connection using a CAT-5 cable.  The internet connection can either be the RJ-45 jack on your cable modem, or a LAN port on your existing router, if you happen to be using a different router already.

Connect your PC to the MT-300's ethernet LAN port, or connect wirelessly.

By default, the IP address of the router as seen from its LAN is

SSH to the router's console using its username and password.  By default, these are root and password, respectively.

ssh -l root
Installing remoteit

At the console, run the following commands:

opkg update
opkg install ./remoteit.ipk

Claim code

When the remoteit installer completes, it will display a short alphanumeric Claim Code that you will need to enter into the Desktop application. 


Sample output is shown below.



Take note of the Claim Code (TL3B46NC in this example), which you will need to copy to the remoteit Desktop application to complete registration of this Device.

Enter the Claim Code to Add your Device to your Account

After installing the remoteit Desktop, open the application and log into your account.

Make sure you are on the "Devices" tab, then click on the "+" in the upper right corner of the left panel:




A dialog will appear where you should paste the registration (claim) code which you copied at the end of the previous step.




Once you have entered the registration code, click on the blue "Register" button. After 5 to 10 seconds, you should see a notification that registration succeeded and you should see the new Device in your list of online Devices.




Click on the pencil icon to the right of the new Device name.  Notice that as you hover the mouse cursor over this icon, the tool tip "CloudShift Configurable" appears.



Trouble downloading the installation package?

If following the instructions above fails, you may not have SSL support enabled for wget.  You may see the error shown below or something similar.

root@device:~# wget
wget: SSL support not available, please install one of the libustream-.*[ssl|tls] packages as well as the ca-bundle and ca-certificates packages.

If this happens, we recommend that you use the curl command instead.  This will also require SSL support to be installed.

Run the following commands:

opkg update
opkg install ca-certificates
opkg install curl
curl -Lo remoteit.ipk
opkg install ./remoteit.ipk
In case of problems with installation


remoteit for OpenWrt is in beta test at this time.  Please report any problems with the procedure above to  Please send us any error messages along with the output of the following commands which you should run on the router's command line:

cat /etc/banner
cat /etc/openwrt_release
cat /proc/cpuinfo


Uninstalling remoteit

To uninstall remoteit, in the event you don't wish to use it any more, or to start over from scratch, run the following.

opkg remove remoteit
rm -rf /etc/remoteit /usr/share/remoteit

In the event you wish to download a new version of the remoteit.ipk file, be sure to remove the older one first, or else wget will fail.

Was this article helpful?
0 out of 0 found this helpful