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

Was this helpful?

  1. Software
  2. Docker

Remote.It Agent

PreviousDockerNextRemote.it Docker Extension

Last updated 1 year ago

Was this helpful?

The docker image is the Remote.It running inside a Docker container.

Running the container in a development environment:

Get your registration code docker command from or Remote.It Desktop by clicking on the "Add Device" button in the left nav and then selecting "Docker" which is in the Add a device. Example below:

docker run -d -e R3_REGISTRATION_CODE="<registration_code>" remoteit/remoteit-agent:latest

This will run a basic Remote.it agent and automatically register it to your Remote.it account based on the registration code.

The command is sufficient for testing but should not be used in a Production environment. There are a few other docker settings to add in order to make this container recoverable so it can be restarted without losing your configuration.

The Remote.it Agent uses a file to keep track of this device's metadata information as well as connection info. In order to maintain this configuration, there are a few more docker settings that need to be set so that when you stop and start the Remote.it Agent container, it comes back as the already registered device. We'll start off with a full production example and explain the different options in the command.

docker run \
  -d \
  --name myname \
  --hostname myname \
  -v $PWD/myname:/etc/remoteit \
  -e R3_REGISTRATION_CODE="<registration_code>" \
  --restart unless-stopped \
  remoteit/remoteit-agent:latest

This is a breakdown of the command:

  • -d = Run this container in detached mode in the background.

  • --name myname = This sets the container name. Otherwise a name is generated for you.

  • --hostname myname = This sets the hostname within the container. The hostname is used by the Remote.It Agent to set the Device Name during registration.

  • -v $PWD/myname:/etc/remoteit = The path on the Docker host that will be mapped to the /etc/remoteit folder within the container. Anything written to the /etc/remoteit folder in the container will show up on the Docker host. When you stop or kill the container, you can restart it and the Remote.it Agent will find the existing /etc/remoteit/config.json.

  • -e R3_REGISTRATION_CODE="<registration_code>" = This is your registration_code that you can get from the Remote.it Desktop by clicking on the + sign in the Device list and selecting "Docker" from the "Add a Device" section.

  • --restart unless-stopped = This insures that the remoteit-agent docker container restarts after a shutdown of the docker daemon such as a power on/off or reboot of the docker host.

RemoteIt Agent
Device Package
app.remote.it