MiROS Linux Guide
for Ubuntu 22.04 LTS


Step 2 Restart your computer

Once you restart computer, MiROS will launch at the background automatically in order to keep constant ssh communication with a robot you will connect to.

Step 1 Install MiROS

Copy and paste the following commands in your Terminal:

For computers on AMD64 chips:

sudo apt-get install wget

wget https://github.com/roboworksdev/miros/raw/main/miros_ssh_proxy.deb

sudo apt-get install -f ./miros_ssh_proxy.deb

For computers on ARM64 chips:

sudo apt-get install wget

wget https://github.com/roboworksdev/miros/raw/main/miros_ssh_proxy_arm.deb

sudo apt-get install -f ./miros_ssh_proxy_arm.deb


Step 3 Register a user account and log in

To access MiROS, simply open your Google Chrome browser and go to this URL:

https://miros.web.app/

Before logging in to MiROS for the first time, please register a user account.

Once you have registered a user account and signed in successfully, you should see the Project Manager page.

Congratulations! You can start your project now.


Step 4 Connect to Robot

4.1 After create your project Workspace, you will enter Mission Control. Click the Connect button to connect to your robot.

4.2 Enter the IP address, the domain ID of your robot and your ssh user name/password. If you wish to load the ROS packages from the robot to MiROS, please check the small box at the bottom.

There are 3 ways you can connect to the robot via Wifi:

Option 1. connect to robot’s wifi hotspot:

SSID: WHEELTEC_CAT2

PASSWORD: dongguan

Using this methods the robot will be the server and give your computer IP address of 192.168.0.xxx. The robot itself will have a static ip of 192.168.0.100 on the wifi network. Sometimes this method does not work on newer macOS system so you may want to try option 2 and 3.

Option 2. connect your computer to robot using an ethernet cable.

The robot will be on ip 192.168.1.100 and you will be automatically assign an address under same subnet, which is 192.168.1.xxx. Note: if you have configure static ip for your ethernet port or adapter before, you will need to change it back to DHCP.

Option 3. connect robot to a Wifi router and connect your computer to the router. Using this appraoch only if you know how to log in the router admin page so that you should be able to find the robot IP in the router admin panel.

4.3 Enter the path to the setup.bash or local_setup.bash file of your robot. Here are the examples:

MiROS Robot Templates -

/home/wheeltec/wheeltec_ros2/install/setup.bash

Other third party robots -

/opt/ros/humble/setup.bash

If you have chosen a robot template to start your project, it’s recommended to choose the “Do not load any packages” option from the Drop-down Menu.

4.4 Build Packages

After connecting to your robot, you may build your project on your robot by pressing the Build Packages button. When you are prompted to enter the target directory. Please copy the below directory and replace <your project> to your preferred project name.

/home/wheeltec/<your project>