Skip to content

Creating Deployments with Robotairâ¿»

Estimated time to read: 3 minutes

Robotair Deployments allow you to define how your ROS applications and supporting services are delivered to your robot fleet. This includes packaging your services using Docker Compose and assigning deployments to robots or fleets all through a unified interface.

This guide will walk you through creating and assigning a deployment in Robotair.


Prerequisitesâ¿»

Ensure you have:

  • A containerized ROS 1 or ROS 2 application
  • An active Robotair account
  • At least one robot connected and visible in the Robotair dashboard
  • Access to a container registry (e.g., Docker Hub, GitLab, or private)

1. Access the Deployments Sectionâ¿»

  • Log in to Robotair and navigate to the Deployments section
  • Click Create Deployment to begin

deployment00.png


2. Upload or Create a Docker Compose Fileâ¿»

You have two options for defining your deployment:

Option 1: Upload an Existing Fileâ¿»

  • Select Upload Compose File
  • Choose a local docker-compose.yml from your machine
  • If your services are built from private images, make sure you've added the appropriate registry credentials under the Secrets section.

deployment01.png


3. Review Deployment Configurationâ¿»

  • After upload, click Next to review the parsed Docker Compose content
  • Validate all key parameters:

  • Image names and tags

  • Command definitions
  • Port mappings
  • Volumes
  • Environment variables
  • Networking setup

deployment02.png


4. Finalize the Deploymentâ¿»

  • If the configuration looks good, click Create
  • You’ll be redirected to the Deployment Overview page

deployment03.png deployment04.png


5. Explore the Deployment Overviewâ¿»

This page displays all key attributes of your deployment:

  • Image Name and Version
  • Startup Command
  • Mapped Ports
  • Volume Mounts
  • Network Configuration
  • Labels and Metadata
  • Environment Variables

deployment05.png


6. Assign the Deployment to Robotsâ¿»

  • From the Deployment Overview page, click Assign
  • Select one or more robots from your fleet
  • Optionally choose which services should run on each robot (per-node granularity)

deployment06.png


7. Monitor Running Servicesâ¿»

  • After assignment, Robotair will automatically trigger deployment on the selected robots
  • The dashboard will display running services per robot in real time

deployment07.png


Success

Your deployment is now live. Robotair ensures consistent rollout, secure image delivery, and per-robot service visibility all from a single pane of glass.