Getting Started

Estimated time to read: 3 minutes

Get your first robot online and ready for deployment using Robotair. This guide walks you through the minimum setup required to build, deploy, and monitor ROS apps at scale or in the lab.

---

🚦 Quick Setup Checklist

• Step 1: Create a Robot
  Go to the Robotair dashboard and register your robot. This will generate a secure onboarding token.

• Step 2: Install the Agent on Your Robot
  Use the one-line script and token from Step 1 to install and connect the robot to Robotair.

• Step 3: Build Your Application
  Containerize your ROS application and set up a GitHub/GitLab CI pipeline.

• Step 4: Deploy to Your Robot
  Create a Docker Compose deployment and push it over-the-air (OTA) to your robot or fleet.

---

🤝 Invite Your Team

Robotair is built for teams. You can invite members from your organization to:

• Monitor deployments and metrics
• Push updates to specific robots or fleets
• Collaborate on builds and CI/CD setup

Head to the Members section in the dashboard to add teammates securely.

---

🧠 Fleet Management

Robotair supports powerful grouping for real-world deployment setups:

• Fleets: Group robots into logical units (e.g., warehouse bots, outdoor units).
• Multi-Computer Robots: Group multiple computers on the same physical robot into one fleet for unified deployments.

This structure helps you roll out updates, monitor systems, and manage configurations consistently.

---

✅ Requirements

• Debian-based OS
  Your robot should run Ubuntu 20.04+ or similar.

• Python ≥ 3.0
  Required to install and run the Robotair client.

• GitHub or GitLab Account
  For CI/CD integration and container image storage.

• Working ROS or ROS 2 App
  Your code should already build and run locally.

Note

Installation of the agent requires the robot ID and secure token, which you get from the dashboard after creating the robot.

---