Installation
Install the rover-agent on a Linux robot and run it as a systemd service.
Requirements
- Linux (the agent is Linux only).
- Cameras exposed through V4L2 (the standard Linux video interface).
- Network access to the Rover Nexus cloud and to your local Zenoh router.
Install with the bootstrap command
The agent is a single self-contained binary, and you don't build it or install it by hand. After adding the robot in the web app, copy its bootstrap command and run it once on the robot. That single command installs the agent and everything it needs, writes its configuration, installs the systemd service, sets up mutual TLS, and enrolls the robot automatically — see Enrollment.
Directories and config locations
The agent uses these locations by default:
| Purpose | Default path |
|---|---|
| Agent config | /etc/rdyn/agent.toml |
| Robot config | <state_dir>/robot.toml |
| Zenoh config | /etc/rdyn/zenoh_config.json5 |
| State directory | /var/lib/rdyn/robot |
| Local data (SQLite) | <state_dir>/assets.db (WAL mode) |
See Configuration for what goes in each file.
Run as a systemd service
The install command registers the agent as a systemd service. Typical management commands:
sudo systemctl enable --now rover-agent
sudo systemctl status rover-agent
journalctl -u rover-agent -f # follow logs
Next steps
- Follow the integrator walkthrough: Install the agent — one bootstrap command installs and enrolls the robot.
- See how Enrollment and mTLS are set up automatically.
- Review the Configuration reference if you need to adjust cameras or capabilities.