remote.it

Remote.it can be a great way to remotely support an Internet-in-a-Box (IIAB).

As of April 2022, 5 IIAB devices can be managed for free, and an unlimited number can be managed for $6/month.

For other approaches, please see http://FAQ.IIAB.IO -> "How can I remotely manage my Internet-in-a-Box?"

Getting Started

Create a remote.it account + consider its desktop application

Browse to https://remote.it (Web Portal) and sign up for an account.
Download the remote.it desktop application e.g. for Windows, macOS or Linux to your own laptop/computer — if you prefer this over the https://remote.it Web Portal and its mobile apps.

COMPARISON: "The Desktop and CLI can [each] support both peer to peer connections and proxy connections [whereas] the Web Portal and API can only support proxy connections" according to https://docs.remote.it/software/device-package/usage

Install remote.it onto an IIAB + register it + authorize services/ports

Set remoteit_install and remoteit_enabled to True in your IIAB's /etc/iiab/local_vars.yml

(If possible, do that prior to installing IIAB, then install IIAB using sudo iiab, and when that's complete go directly to Step 3. below.)
Make sure your IIAB is connected to the Internet.

Then install and enable remote.it (its Device Package) on your IIAB, by running:
```
cd /opt/iiab/iiab
sudo ./runrole remoteit
```
Or if necessary reinstall the latest, by running:
```
cd /opt/iiab/iiab
sudo ./runrole --reinstall remoteit
```
(While rarely needed, both above also install the optional /usr/bin/remoteit command-line interface (CLI), which offers a few more features than the Device Package.)
To obtain your IIAB's 8-character remote.it claim code (allowing you to make a remote connection to this IIAB device) run:
```
sudo grep claim /etc/remoteit/config.json
```
The claim code must be used within 24 hours, per: https://docs.remote.it/device-package/installation#2.-update-your-package-manager-and-install

If your claim code has expired, please reinstall the latest remote.it (in Step 2. above!)
Submit the claim code at https://remote.it (log into the Web Portal), or within the remote.it desktop application if you installed that on your own laptop/computer.

Either way, click on the '+' icon to enter the remote.it claim code (to register the IIAB device to your account) as shown in this screenshot: https://docs.remote.it/software/device-package/installation#3.-claim-and-register-the-device
Authorize services/ports (e.g. SSH, HTTP, etc) for your IIAB device, as shown in these screenshots: https://docs.remote.it/software/device-package/installation#4.-set-up-services-on-your-device

SUMMARY: One or more remote.it "Services" need to be authorized (registered) to allow remote access to your IIAB device: https://support.remote.it/hc/en-us/articles/360060992631-Services

EXAMPLES: SSH (port 22) and/or HTTP (port 80): https://support.remote.it/hc/en-us/articles/360058603991-Configuring-remoteit-Services-on-devices-with-remote-it-Desktop

Docs

Known Issues

~~2021-10-27: This needs to be enhanced rather urgently, so remote.it also works when IIAB is installed on Raspberry Pi OS 11 (Bullseye), Ubuntu, Mint and Debian:~~ #3006
2021-10-29: The above OS issues should be resolved by PR #3007, PR #3009 and PR #3010 — but this needs final testing! (Initial testing occurred on [1] 32-bit Raspberry Pi OS Lite on Raspberry Pi 4 and [2] Ubuntu Server 20.04 on x86_64 VM.)

5.8 KiB Raw Blame History