iiab/roles/remoteit

Remote support for Internet-in-a-Box

A great to remotely support an Internet-in-a-box (IIAB) is to install and config remote.it offical website, for other approaches, please see FAQ under the topic 31 "How can I remotely manage my Internet-in-a-Box?"

Getting started

Create a remote.it account

1. Go to remote.it offical website and sign up for an account
2. Download the desktop verison (optional)

Install remote.it onto an IIAB

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

2. Install and enable it (remote.it) on your IIAB, by running:

   cd /opt/iiab/iiab
   sudo ./runrole remoteit
   

3. To obtain this IIAB's 8-character remote.it claim code, allowing you to make a remote connection to this IIAB, 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 not used before then, here is an example (version & architecture can change in the .deb filename below!) to re-run this installation command, to get a new claim code:

   sudo apt reinstall /opt/iiab/downloads/remoteit-4.13.5.armhf.rpi.deb
   

4. After you've installed the https://remote.it client software onto a separate computer or device (e.g. your own laptop) click on the '+' icon, then enter the remote.it claim code (for the IIAB that you need to connect to).

   As shown in the screenshot here: https://docs.remote.it/device-package/installation#3.-claim-and-register-the-device

Usage

1. Log into your remote.it account or open the desktop version
2. Add devices
3. Create http services to access the devices in your browser

For more information remote.it Getting started

Advanced

For "auto-registration" of remote.it, and other more advanced configuration options, please review:

• https://docs.remote.it
• https://support.remote.it
• https://support.remote.it/hc/en-us/articles/360044424612-1-Create-an-Auto-Registration
• https://support.remote.it/hc/en-us/articles/360044424672-1-Device-Setup-for-Auto-Bulk-Registration

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.)