Getting Started

Where to get started with ROS 2

Installation

ROS is released as distributions, also called “distros”, with more than one ROS distribution supported at a time. Some are releases come with long term support (LTS), meaning they are more stable and have undergone extensive testing. Other distributions are newer with shorter lifetimes, but with support for more recent platforms and more recent versions of their constituent ROS packages. See the distributions list for more details. Generally a new ROS distro is released every year on world turtle day, with LTS distros being released in even years. We currently recommend one of the versions below:

ROS Noetic Ninjemys logo

Get ROS Noetic Ninjemys on Ubuntu Linux

(Recommended for Latest ROS 1 LTS)

Install

ROS Foxy Fitzroy logo

Get ROS Foxy Fitzroy on Ubuntu Linux, macOS, or Windows 10

(Recommended for Latest ROS 2 LTS)

Install

ROS Galactic Geochelone logo

Get ROS Galactic Gechelone on Ubuntu Linux, macOS, or Windows 10

(Recommended for Latest ROS 2)

Install

Support

There are several mechanisms in place to provide support to the ROS community, each with its own purpose: package documentation, Q&A forum, discussion forum, package index, and of course the issue trackers. It is important to pick the right resource to reduce response time, avoid message duplication, and promote the discussion of new ideas.

ROS Package Documentation

Documentation for core ROS packages as well as package specific content is hosted on docs.ros.org. On this site you can find the core tutorials and documentation for the project as well as generated API documentation for individual packages.

ROS Answers

If the documentation doesn’t address your problem, ROS Answers is next. Take heart: it is very likely that someone else has faced the same problem before, and that it’s covered among the more than 10,000 questions at ROS Answers. Start by searching for questions similar to yours; if your question isn’t already asked, post a new one. Be sure to check the guidelines on how to prepare your question before posting.

ROS Discourse Forums

To stay up-to-date on the latest developments within the ROS community, you’ll want to join the ROS Discourse forums. These forums are the place for announcements, news, and discussions of general interest. The ROS Discourse is not the right place to ask troubleshooting questions or report bugs; please use the other support resources listed above instead.

ROS Index

When you want to find out information about a specific package the index is the best place to start. It connects you to all the important locations relevant to a package. In addition to the official documentation for ROS packages, the wiki contains two key resources you should consult: the Troubleshooting guide and the FAQ. Solutions to many common problems are covered in these two pages. If you have ever used PyPI you should feel right at home on ROS Index.

Issue Trackers

When you’ve identified a bug (e.g., as a result of a discussion at ROS Answers), or when you want to request a new feature, head to the issue trackers. Links are provided in the packages metadata available on ROS Index. When reporting a bug, be sure to provide a detailed description of the problem, the environment in which it occurs, any detail that may help developers to reproduce the issue, and if possible, a debug backtrace.