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 — 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 — there are 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