Step 1: Install Docker Desktop App

Docker contains your ROS images and connects your MiROS web interface with your robot via SSH connection. To use MiROS, you need to install Docker first.

Step 2: Download MiROS Installer

Step 3: Install, Sign up, Set up.

  1. Double-click the MiROS Installer. Your default Terminal app will start downloading ROS 2 Humble for MiROS.

  2. After about 5 minutes, ROS 2 Humble will be loaded into MiROS. Your default web browser will automatically openand connect to http://localhost:8000.

  3. If the page does not load automatically, please copy and paste http://localhost:8000 into your browser to access the MiROS homepage.

  4. If you don’t have a MiROS account, sign up.

  5. Once signed in, you will land on the Project Manager page. You can select a robot template or create a new project. By default, all projects run on ROS 2 Humble.

Installation Guides

If you need more help, please check the below Step-by-step Installation Guides or contact us.

MiROS Agent

If you want to connect MiROS to your own robot and run Rviz/RQT on MiROS, you need to ssh into your robot and install MiROS Agent by copying and pasting the below command lines:

sudo apt-get install wget
wget https://github.com/roboworksdev/miros/raw/main/miros_dependencies.deb
sudo apt-get install -f ./miros_dependencies.deb

After installing MiROS Agent, please restart your robot. Then run the below command line to check whether MiROS Agent is installed successfully on your robot:

systemctl status miros_novnc_startup

If the status shows “Active”, it means you have installed MiROS Agent on your robot successfully.

Or see it in action.

Check the below video recorded in real time.

Please provide feedbacks.

Your valuable feedbacks and inputs are highly appreciated.