external/iiab
1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-03-09 15:40:17 +00:00
Code Issues Releases Wiki Activity
iiab/roles/remoteit
History
root a40183fd2e Fast /usr/bin/iiab-remoteit generates new claim code + optionally upgrades
2022-04-03 21:57:23 -04:00
..
defaults /usr/bin/iiab-remoteit to quickly obtain a new claim code 2022-04-02 23:41:49 -04:00
tasks Fast /usr/bin/iiab-remoteit generates new claim code + optionally upgrades 2022-04-03 21:57:23 -04:00
templates Fast /usr/bin/iiab-remoteit generates new claim code + optionally upgrades 2022-04-03 21:57:23 -04:00
README.md Fast /usr/bin/iiab-remoteit generates new claim code + optionally upgrades 2022-04-03 21:57:23 -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).

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 + install its desktop application

  1. Browse to https://remote.it (Web Portal) and sign up for an account.

  2. Download and install the remote.it desktop application (e.g. for Windows, macOS or Linux) on your own laptop/computer. Their https://remote.it Web Portal and mobile apps are also sometimes possible, but less functional.

    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

Generate a remote.it claim code for your IIAB + register it + authorize services/ports

Prerequisite: Find an IIAB with remoteit_installed: True in /etc/iiab/iiab_state.yml.

  1. Run sudo iiab-remoteit

    Hit [Enter] twice if you want to quickly generate a new claim code for your IIAB.

    The claim code is stored in /etc/remoteit/config.json and must be used within 24 hours.

  1. Submit the claim code within the remote.it desktop application on your own laptop/computer. Or if you prefer, do that by logging into their Web Portal at: https://remote.it

    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.

  2. Authorize services/ports (e.g. SSH, HTTP, etc) for your IIAB device, as shown in these screenshots.

    SUMMARY: One or more remote.it "Services" need to be authorized (registered) to allow remote access to your IIAB device:
    3600609926-Services

    EXAMPLES: SSH (port 22) and/or HTTP (port 80):
    3600586039-Configuring-remoteit-Services-on-devices-with-remote-it-Desktop

How to I disable remote.it on my IIAB?

  1. Run sudo nano /etc/iiab/local_vars.yml to set remoteit_enabled: False

  2. Then run:

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

  3. If want to completely remove the remote.it software and its settings, also run:

    sudo apt purge "remoteit*"
sudo rm /usr/bin/remoteit

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