oem-and-bulk-provisioning-auto-registration-into-your-account-field-production.md
For the complete documentation index, see llms.txt. This page is also available as Markdown.
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.
Follow the steps to create a product which defines the services which you want on your devices
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.
Copy
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.
Copy
sudo mkdir -p /etc/remoteit
sudo vi /etc/remoteit/r3.env
Example contents of r3.env:
Copy
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.
PreviousProduction ImageNextRegistration into a User's Account
Last updated 14 days ago
Was this helpful?