external/iiab
1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-02-13 03:32:12 +00:00
Code Issues Releases Wiki Activity
iiab/roles/remoteit
History
A Holt 72949d39b1
remoteit/README.md: Clean up explanations + links
2022-03-31 00:41:35 -04:00
..
defaults remoteit/defaults/main.yml: remoteit_version: 4.13.7 -> 4.14.1 2022-03-04 17:22:41 -05:00
tasks Ansible indentation norm across 7-8 roles 2022-01-07 05:29:54 -05:00
README.md remoteit/README.md: Clean up explanations + links 2022-03-31 00:41:35 -04: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. Browse to https://remote.it (Web Portal) and sign up for an account.

  2. Download remote.it's 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.

    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

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

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

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

    While rarely needed, FYI the above also installs the optional /usr/bin/remoteit command-line interface (CLI).

  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 necessary, run this command to get a new claim code: (adjust version & architecture in the .deb filename as appropriate!)

    sudo apt install /opt/iiab/downloads/remoteit-4.14.1.armhf.rpi.deb

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

  5. Set up 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 set up (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.)