| .. | ||
| defaults | ||
| tasks | ||
| templates | ||
| 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
-
Browse to https://remote.it (Web Portal) and sign up for an account.
-
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 sufficient, 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 any IIAB with remoteit_installed: True in /etc/iiab/iiab_state.yml (this is the default!) It means that the remote.it Device Package is installed on your IIAB, most important. It also means the strictly optional /usr/bin/remoteit command-line interface (CLI) is installed, offering a few more features than the Device Package.
-
Run
sudo iiab-remoteitto enable remote.it on your IIAB.Hit
[Enter]twice if you want to quickly generate a new claim code for your IIAB.(The claim code is put in
/etc/remoteit/config.jsonand must be used within 24 hours.)
-
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 remote.it account) as shown in this screenshot.
-
Authorize services/ports (e.g. SSH, HTTP, etc) for your IIAB device, as shown in these screenshots.
SUMMARY: One or more remote.it "Services" needs to be authorized (registered) to allow remote access to your IIAB device.
EXAMPLES: Add an SSH Service on port 22 and/or add an HTTP Service on port 80 (screenshot guide).
How to I disable remote.it on my IIAB?
-
Run
sudo iiab-remoteit-off -
If you also want to completely remove all remote.it software and its settings, run:
sudo apt purge "remoteit*" sudo rm /usr/bin/remoteit
Docs
- https://docs.remote.it
- https://support.remote.it
- https://support.remote.it/hc/en-us/categories/360003417511-Getting-Started
- https://support.remote.it/hc/en-us/articles/360061228252-Oops-I-cloned-an-SD-card-
- https://support.remote.it/hc/en-us/articles/4404156674445-Subscriptions-and-Licensing
- https://support.remote.it/hc/en-us/articles/360041590951-Why-does-the-address-time-out-
- https://support.remote.it/hc/en-us/articles/360047705691-Desktop-Application-Release-Notes
- https://support.remote.it/hc/en-us/articles/4492289672973-Two-ways-of-using-remote-it-Connections
- https://support.remote.it/hc/en-us/articles/4422773654669-Streamlined-installation-for-Linux-and-Raspberry-Pi-platforms
- https://support.remote.it/hc/en-us/articles/360051668711-Updating-the-remoteit-or-connectd-packages-using-a-remote-it-SSH-connection
- https://remote.it/legal/
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: #30062021-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.)