Field Production

The simplest bulk registration method — run a one-line command on each device to install Remote.It with a custom name and pre-defined services.

This is a method to register multiple devices into your account with a pre-defined set of services. This is the easiest method.

One-line command Run a command on each device to install, which will allow a custom name, pre-defined services (device template), and optionally, a fixed version.

1. Create a Product

Follow the steps to create a product which defines the services which you want on your devices

2. Run your installation

Using the code you created in the previous step, run the one line code. Optionally add the arguments for the device name and software version.

Variable Name	Option Type	Description
R3_REGISTRATION_CODE	String	Registration Code which defines the account and services for the device
R3_DEVICE_NAME	String	(Optional) Device name to appear in Remote.It. If not defined, then R3_DEVICE_NAME environment variable followed by device HOSTNAME is used
R3_VERSION	String	(Optional) Device package version to install. If not defined, then the latest release is used.

Run the code on each device (example shows all 3 options). If an option is not needed, remove it.

R3_REGISTRATION_CODE="YOUR-REGISTRATION-CODE" R3_VERSION="XXX" R3_DEVICE_NAME="My Device" sh -c "$(curl -L https://downloads.remote.it/remoteit/install_agent.sh)"

As an alternative to using variables as command-line arguments as shown above, Device Package version 5.4.2 and later supports overriding device name, model name, and serial number values using an env file (/etc/remoteit/r3.env). By preparing this file before you run the installation command, you can override each piece of information.

sudo mkdir -p /etc/remoteit
sudo vi /etc/remoteit/r3.env

Example contents of r3.env:

R3_DEVICE_NAME=sample_device
R3_DEVICE_MODEL=sample_model
R3_DEVICE_SERIAL=sample_serial

Using a file with the example above and running the one-line installation command (shown below), the following device will be created. The R3_REGISTRATION_CODE is the Registration Code which defines the account and services for the device.

R3_REGISTRATION_CODE="YOUR-REGISTRATION-CODE" sh -c "$(curl -L https://downloads.remote.it/remoteit/install_agent.sh)