external/iiab
1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-02-13 11:42:08 +00:00
Code Issues Releases Wiki Activity
iiab/roles/remoteit
History
A Holt cb5be0a903
Merge pull request #3083 from holta/download_timeout 
osm_vector_maps was repeatedly failing to install, so use 'timeout: "{{ download_timeout }}"' with get_url (in 10 roles!) [& change IIAB's 'download_timeout: 200' to 100 sec]
2021-12-26 13:03:51 -05:00
..
defaults remoteit/defaults/main.yml: 4.13.5 -> 4.13.6 2021-12-26 11:25:56 -05:00
tasks get_url 'timeout: "{{ download_timeout }}"' in 10 roles 2021-12-26 10:24:31 -05:00
README.md Tweak version# in roles/remoteit/README.md 2021-12-26 11:29:15 -05:00

README.md

Remote support of an Internet-in-a-Box using https://remote.it

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

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

  1. Go to the https://remote.it website and sign up for an account.
  2. OPTIONAL: Download remote.it's desktop application e.g. for Windows, macOS or Linux.

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.6.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 Summary

  1. Log into the https://remote.it Web Portal, or open its desktop application.
  2. Add Devices (e.g. your IIAB).
  3. Understand that each Device will need to contain one or more remote.it Services.

Summary of remote.it Services: https://support.remote.it/hc/en-us/articles/360060992631-Services

For more info, please see remote.it's Getting Started pages.

Advanced

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

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