LogoLogo
HomeSupportCommunity
  • Introduction
    • Overview
    • Get Started
      • Platforms & Packages
      • Use Cases
    • Glossary of Terms
  • Software
    • Bluetooth Wifi Onboarding Package (r3onboard)
    • Device Package
      • Supported Platforms
      • Installation
      • Usage
    • NPM Package
    • CLI
      • Supported Platforms
      • Installation
    • Docker
      • Remote.It Agent
      • Remote.it Docker Extension
    • Desktop
      • Installation
    • Web Portal & Mobile
    • Custom Solutions
  • Features
    • Services
      • SSH
      • RDP and VNC
      • SMB and CIFS
      • HTTP/S
      • Database
      • Redis
      • UDP
      • Gaming
      • VPN
    • Connection Options
      • LAN Sharing
      • Jump Service
      • Peer-2-Peer & Proxy
    • Logging
    • Organizations
  • Developer Tools
    • Authentication
    • API
      • Using Developer Tools
      • Usage
        • Devices and Services
        • Event Logs
        • Connections
        • Access Keys
        • Device Sharing
        • Custom Attributes
        • Scripting
    • CLI Usage
    • Webhooks
      • Slack Integration
    • Docker
    • Device Scripting
    • Zero-Trust AWS Access
      • AWS RDS (Postgres and MySQL)
    • Zero Trust Azure Cloud Access
    • Zero Trust Google Cloud Access
  • OEM & Bulk Provisioning
    • Overview
    • Auto Registration into Your Account
      • Create a Product
      • Production Image
      • Field Production
    • Registration into a User's Account
Powered by GitBook
On this page
  • Setup
  • 1. Install remote.it package on your device with empty "registration" file
  • 2. Copy the image onto another device
  • 3. User receives the device and registers his account
  • 4. User configures the device via the desktop application

Was this helpful?

  1. OEM & Bulk Provisioning

Registration into a User's Account

PreviousField Production

Last updated 1 year ago

Was this helpful?

This method of device setup allows for manufacturing or mass setup of devices which have the same platform and OS distribution. This can support complete image writes. Once the customer receives their device, there would be a mechanism to get the customer's account license key written to the device's registration file on the system. This method will result in the following when the device boots and connects to the internet for the first time after the registration file is present:

  • The device will be registered to the customer's account

  • The device will need to be configured with appropriate services for their use.

This method is supported for any platforms which can install the .

Setup

Using a device which will be used in your production line, install the device package and test the setup of the device including services and connections before creating master device or image with the bellow procedure. This is merely to test that the installation and functionality of remote.it are as desired.

1. Install remote.it package on your device with empty "registration" file

Download the compatible package for your device from the .

Create a file in /etc/remoteit called "registration" (no extension) with nothing in it before installing the package. This is essential in case the device is turned on with internet connection to prevent the device from registering with remote.it prematurely. And please make sure no other files in /etc/remoteit when installing the package.

sudo mkdir -p /etc/remoteit
sudo touch /etc/remoteit/registration 

Install the package onto your device.

sudo apt install ./remoteit-4.14.1.armhf.rpi.deb

2. Copy the image onto another device

For example, if this were a raspberry pi, you would copy the SD card onto a new SD card and insert it into the new device

If this device is something you will deliver to a customer, you may want to have a local interface on the device which will take the input of the customer's license key, write it to the /etc/remoteit/registration file and execute /usr/share/remoteit/refresh.sh. (steps for the user to get their key can be found below) Upon reboot and first time online this device will automatically register to the account to which the license belongs. Then the user will be able to add services to the remoteit device using the Desktop Application.

3. User receives the device and registers his account

The user will need to retrieve their remote.it license from the Desktop Application, click "...More", then click on "Licensing". Then copy the License Key.

The user will need to have the license key written to the /etc/remoteit/registration file either manually or via an interface that you provide on the device received.

Once the license key has been written to the device's /etc/remoteit/registration file, then the device can be refreshed (execute /usr/share/remoteit/refresh.sh) and when the device is able to reach the internet (wifi, cellular or ethernet connection), it will register to the user's account

4. User configures the device via the desktop application

The user may need to click the refresh the application icon for the device to appear in the device list.

The user will need to have the remote.it desktop application installed on a device. . Then they can create an account from there if they do not already have one.

Following the , the user can add and remove services via the desktop application. You may want to provide your user

There are distributions for Windows, Mac, and Linux
Device Package
Device Package
directions here