ROS 2 Setup Guide

An exhaustive guide for installing a ROS 2 development environment

View project on GitHub

ROS 2 Setup Guide

Table of Contents

This guide will help you install ROS 2 on your machine.

At the end of each page of this tutorial there is a section named “Next steps” that will guide you through all the process.

Choose the guide that fit best your needs from the three available below.

1. Dual boot Ubuntu

Install Ubuntu alongside Windows on your hard drive. You will be prompted at each boot with the choise of the operating system to run. If you want to install Ubuntu on your machine, follow the setup guide for Ubuntu in dual boot.

This operation must be performed really carefully and may be disruptive. Please, before proceeding read carefully the guide. If any part of the guide is not clear, ask someone before proceeding with the installation.

  1. Dual boot Ubuntu setup guide
  2. ROS2 installation

2. WSL2 Ubuntu

Run Ubuntu inside Windows using a functionality called Windows Subsystem for Linux (WSL). This option is not reccommended for PCs with low performances. The suggested minimum requirements are 16 GB of RAM and an i5-8th generation processor or equivalent.

  1. WSL2 Ubuntu setup guide
  2. ROS2 installation

3. Mac M1/M2 (experimental)

Please note that this is an experimental setup and it is not tested.

Run Ubuntu inside a UTM virtual machine on a Mac equipped with M1/M2 processors. If you have a Mac with an Intel processor you can install Ubuntu in dual boot mode folowing this instructions.

  1. Mac M1/M2 setup guide
  2. ROS2 installation