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.

MiROS is the intuitive, easy to use application that is changing the face of ROS development across multiple platforms, now being compatible with Windows and Mac as well as Linux, negating the need for VM involvement.

In order to utilise MirOS you will of course need to install it on your hardware – and this does involve downloading Docker, a platform that allows developers to package software applications into standardized units called containers, prior to installation. The process is simple and fast, and there is a full installation guide on our website, typically with no set up or configurations, you can be actively using MiRos on your PC within 15 minutes.

MiROS is equally suited for both beginners and advanced users or developers, and comes with ready to use templates for your individual robots; these templates contain all the codes and files that you will need to get your project up and running with a minimum of fuss. Advanced developers can access the full Code Editor which facilitates modifying code in real time.

MiROS has been designed to help save you time and money; the drag and code functionality significantly reduce the time you may have to spend on syntax issues thereby allowing more time to be spent on the fundamentals of programming logic. Additionally, your progress is automatically saved every few seconds and system security is high mitigating many risks.

With robotics and associated technology moving forward at a breakneck speed, keep ahead of the game by taking advantage of the benefits of using MiROS, it is a decision that you will not regret.