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.

In this page there is an overview for each of the proposed methods and than a link that will guide you throught the installation process.

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

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

1. WSL2 Ubuntu (Suggested)

Windows Subsystem for Linux (WSL) is a functionality of Windows that let you run Ubuntu in a terminal while running Windows. In this way, we can run ROS 2 in the simpliest and most efficient way as we were running Ubuntu on our PC. You will need at least 10 GB of free space.

First of all, you will need to activate the WSL2 functionality, then you will be guided in the installation of ROS 2.

Start from WSL2 Ubuntu setup.

2. 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.

Start from Dual boot Ubuntu setup.

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.

Start from Mac M1/M2 setup guide.