Configure the Agent
Goal: Adjust the agent's configuration after install — for cameras, capabilities, and settings.
The bootstrap command already writes a working configuration and sets up identity and mutual TLS. You only need this page when you want to change something, such as which cameras to use or which capabilities the robot advertises. Identity and TLS are configured automatically during enrollment and rarely need manual edits.
Before you begin
- The bootstrap command has been run (see Install the Agent).
- You can edit files as root on the robot.
- Restart the service after editing config so changes take effect (see Verify Agent Connectivity).
Config files reference
The agent's config files, identity/TLS fields, and precedence rules are documented in the Configuration reference. For everyday changes you mostly edit <state_dir>/robot.toml (default /var/lib/rdyn/robot/robot.toml); identity and TLS are written during enrollment and rarely need hand edits.
What to edit
- Cameras — pin V4L2 devices/formats for teleop video. See Configure a Camera.
- Capabilities — declare the services the robot advertises. See Declare Capabilities.
- Settings — seed the robot's key/value settings store. See Configure Robot Settings.
After editing any config, restart the service so the changes take effect:
sudo systemctl restart rover-agent
Next steps