Skip to content

Install the Agent

Goal: Get a robot connected to Rover Nexus by running one bootstrap command on it. That single command installs the agent, writes its configuration, sets up mutual TLS, and enrolls the robot, all automatically.

Before you begin

  • A Linux robot you can reach over a terminal with sudo access.
  • Network egress from the robot to the Rover Nexus cloud. The exact outbound endpoints and ports are coming soon; if you need them for firewall planning now, contact [email protected].
  • The robot has been added in the web app and you have its bootstrap command. See Add a robot. The command contains a single-use token and is shown only once.
  • One or more V4L2 cameras attached if you plan to use teleop video (optional for install).

Steps

  1. Open a terminal on the robot.

  2. Paste the bootstrap command exactly as it was shown in the web app and run it. It looks roughly like:

bash curl -fsSL "<install-url>" | sudo bash -s -- --token <bootstrap-token>

The exact command is shown in the web app when you add a robot.

  1. Let it finish. The command runs unattended, with no further manual steps.

What the bootstrap command does

In one pass, the command:

  • Installs the agent binary and a systemd service that runs it on boot.
  • Creates a dedicated service user and the runtime directories it owns.
  • Writes the agent configuration: the config directory /etc/rdyn/ (agent.toml, zenoh_config.json5, the CA root) and the state directory (default /var/lib/rdyn/robot/).
  • Enrolls the robot automatically: the agent obtains a device certificate and saves its identity. For how the CSR flow works, see Enrollment.
  • Brings up mutual TLS (mTLS) so all robot-to-cloud traffic is authenticated and encrypted from the first connection.

Note. You do not run a separate enrollment step; enrollment is part of the bootstrap command. Manual enrollment is only for rare recovery cases; see Enroll a robot.

Next steps