Skip to content

Add a Robot

Goal: Register a robot in a fleet. For a Robot or Device, copy the install command that connects its agent to Rover Nexus.

Before you begin

  • You need a fleet to add the robot to. See Create a fleet.
  • You need permission to create robots on that fleet (typically Fleet Manager).
  • For a Robot or Device, have the onboard Linux device ready for the integrator to run the install command.

Steps

  1. In the top navigation, click Fleet.
  2. Click Add Robot. The Add Robot dialog opens.
  3. Under Type, leave Robot selected, or choose Simulator, Device, or API. The steps below are for Robot. The other three are in Other types.
  4. In Robot Name, enter a name.
  5. (Optional) Set an initial Status (for example, Ready or Maintenance).
  6. Under Fleet, select the fleet this robot belongs to.
  7. Under Billing Organization, select the organization responsible for the robot. Only organizations where you're an admin or owner appear.
  8. (Optional, and hidden for a simulator) Under Configuration Profile, pick a saved robot.toml. The device receives that file as it enrolls. Choose Create a profile or Create or edit profiles to open Robot Configuration Profiles, then refresh the list. Leave it on No profile to keep the installer's file.
  9. (Optional) Set Turning radius, Brake rate, and the footprint. A new robot starts as a 1 m × 1 m square centered on the origin, with forward toward +Y. A profile that has its own footprint replaces that square. Brake rate defaults to −0.5 m/s². See Configuration.
  10. (Optional) Fill in Vehicle Make, Vehicle Model, and Link.
  11. Click Add Robot.
  12. For a Robot or Device, a confirmation appears with the Robot Bootstrap Command. Copy it now. It's required to install and authenticate the robot agent, and it won't be shown again. A Simulator or API robot finishes with a success message and does not show that command.
  13. For a Robot or Device, send the command to whoever sets up the onboard device. They run it once on the robot's Linux terminal, and it installs the agent, sets up mutual TLS, and enrolls the robot automatically. If you chose a profile, that file is the robot.toml the agent starts with.

Other types

  • Simulator. Optional Start Latitude and Start Longitude appear under Type. Set both, or leave both blank. The configuration profile is hidden. Add Robot does not show an install command. The robot stays inactive until you activate it.
  • Device. The name, make, and model fields are labeled Device Name, Device Make, and Device Model. Turning radius and brake rate are hidden. Add Robot still shows the bootstrap command.
  • API. The form matches Robot, with three required fields between Robot Name and Status: Integration Type, Integration ID, and Secret Key. Integration Type has one choice, Polymath Robotics, and it is already selected. Add Robot stores those values with the robot and does not show the bootstrap command.

Next steps