Skip to content

Upgrade the Agent

Goal: Upgrade the rover-agent on a robot to a newer version with minimal downtime.

Before you begin

  • SSH access with sudo on the robot.
  • The robot is already installed and enrolled (see Install the Agent).
  • The target version you want to move to. Where versions are published is coming soon; in the meantime, contact [email protected].

Before you upgrade

  • Note the currently installed version:

bash rover-agent --version

  • Back up the config and state directories so you can roll back:

bash sudo cp -a /etc/rdyn /etc/rdyn.bak sudo cp -a /var/lib/rdyn/robot /var/lib/rdyn/robot.bak

Steps

The supported upgrade mechanism is coming soon; for upgrade assistance in the meantime, contact [email protected].

A typical flow is:

  1. Stop the service:

bash sudo systemctl stop rover-agent

  1. Install the new agent version.

  2. Start the service again:

bash sudo systemctl start rover-agent

  1. Confirm the new version is running and the robot reconnects:

bash rover-agent --version sudo systemctl status rover-agent sudo journalctl -u rover-agent -f

Then check the robot shows online in the web app (see Verify Agent Connectivity).

Roll back

If the upgrade misbehaves, reinstall the previous version, restore the backed-up /etc/rdyn and state directory, and restart the service. Your existing device certificate and robot_id remain valid, so no re-enrollment is needed. A detailed rollback procedure is coming soon; for help, contact [email protected].

Next steps