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
      • 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
  • 1. Create a Product
  • 2. Run your installation

Was this helpful?

  1. OEM & Bulk Provisioning
  2. Auto Registration into Your Account

Field Production

PreviousProduction ImageNextRegistration into a User's Account

Last updated 16 days ago

Was this helpful?

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 on each device which will allow a custom name, pre-defined services (device template), and optionally, fixed version.

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

Product Bulk 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 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="XXXXXXXX" 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 Product Bulk Registration Code which defines the account and services for the device.

R3_REGISTRATION_CODE="XXXXXXXX" sh -c "$(curl -L https://downloads.remote.it/remoteit/install_agent.sh)"
Follow the steps to create a product