View on GitHub Join Tech Community

ROSOnWindows

ROS on Windows Documentation staging repo

ROS Logo

ROS on Windows is experimental.

Setup

Prerequisites

Binary Package Installation

To set up ROS for Windows follow these recommended steps:

Install ROS for Windows

To get things started, install the recommended desktop metapackage. A Metapackage is a collection of other packages. The Desktop metapackage refers to a number of other packages needed to build, run, debug and visualize a robot.

Advanced Tips: To co-exist with ROS2, one can isolate and redirect %ChocolateyInstall% install space. The example is as followed:

mkdir c:\opt\chocolatey
set ChocolateyInstall=c:\opt\chocolatey
choco source add -n=ros-win -s="https://roswin.azurewebsites.net/api/v2" --priority=1
choco upgrade ros-melodic-desktop -y

:: Next time when upgrading the installation.
set ChocolateyInstall=c:\opt\chocolatey
choco upgrade ros-melodic-desktop -y

Using ROS on Windows

ROS makes heavy use of the Windows Command Prompt. You will often find that you need to have many command prompts open at once.

NOTE:

Each command prompt you open where you intend to use ROS commands, you’ll need to run the setup script. It is helpful to change the ROS shortcut to add && c:\opt\ros\melodic\x64\setup.bat

Now you are all set to further explore ROS Tutorials. Microsoft has a staging fork of the ROS tutorials which should be used instead of the repository in the tutorials.

If you are new to ROS on Windows, please visit the Differences between ROS on Windows and ROS on Linux page which describes some differences you’ll encounter between what you see in the ROS tutorials and running on Windows.

Getting Help

If you need help with ROS or ROS on Windows, please check out the troubleshooting page

Stay Up to Date

Builds are updated nightly. If you want to move your environment forward, use Chocolatey’s upgrade feature: