Onboarding Robots to Robotair

Estimated time to read: 3 minutes

This guide walks you through onboarding your robot to the Robotair platform. Once connected, your robot can receive over-the-air (OTA) updates, system configurations, and be monitored in real-time through the Robotair dashboard.

---

Prerequisites

To get started, ensure you have:

• A Robotair account
• Remote SSH access to the target robot

---

1. Access the Robotair Dashboard

• Log into your Robotair account
• Navigate to the Robots section in the main dashboard

---

2. Create a New Robot Entry

• Click Create Robot
• Give your robot a unique and descriptive name
• Click Save

---

3. Connect Your Robot

• After saving, you’ll see an onboarding command generated by Robotair
• SSH into your robot and run the command

This command installs the Robotair Agent and registers the robot with your Robotair organization using a secure token.

---

4. Establish a Secure Connection

• The agent uses a certificate-based handshake to establish a secure TLS connection
• You can retrieve the robot's connection credentials later from the Robot Details page

---

5. Assign and Deploy Software

Once the robot is connected, you can deploy your ROS software directly from Robotair:

1. Click Assign Deployment
2. Select a preconfigured deployment
3. Click Assign
4. Hit Deploy to start the OTA process

---

6. Monitor Deployment Status

• You’ll receive an immediate status update once deployment is initiated
• Once completed, Robotair displays the list of running services

---

7. View System Metrics

Robotair automatically collects and displays system-level metrics such as:

• CPU and memory usage
• Agent status and heartbeat
• Deployment logs and runtime diagnostics

---

Success

Your robot is now successfully connected to Robotair and ready to receive updates, monitor health, and participate in fleet-wide rollouts.