[Documentation] [TitleIndex] [WordIndex

Debian install of ROS Noetic

The ROS build farm builds Debian packages for several Ubuntu platforms, listed below. These packages are ready to use so you don't have to build from source. You can check the status of individual packages here.

Note that there are also packages available from Ubuntu upstream. Please see UpstreamPackages to understand the difference.

If you rely on these packages, please support OSRF.

These packages are built and hosted on infrastructure maintained and paid for by the Open Source Robotics Foundation, a 501(c)(3) non-profit organization. If OSRF were to receive one penny for each downloaded package for just two months, we could cover our annual costs to manage, update, and host all of our online services. Please consider donating to OSRF today.


Configure your Debian repositories

Configure your Debian repositories to allow "contrib" and "non-free". You can follow the Debian guide for instructions on doing this.

Setup your sources.list

Setup your computer to accept software from packages.ros.org. ROS Noetic ONLY supports Buster (Debian 10).

  • sudo sh -c 'echo "deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-latest.list'


Source Debs are also available

Set up your keys

  • sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654


First, make sure your Debian package index is up-to-date:

  • sudo apt update

Now pick how much of ROS you would like to install.

  • Desktop-Full Install: (Recommended) : Everything in Desktop plus 2D/3D simulators and 2D/3D perception packages

    • sudo apt install ros-noetic-desktop-full

      or click here

    Desktop Install: Everything in ROS-Base plus tools like rqt and rviz

    ROS-Base: (Bare Bones) ROS packaging, build, and communication libraries. No GUI tools.

    • sudo apt install ros-noetic-ros-base

      or click here

There are even more packages available in ROS. You can always install a specific package directly.

  • sudo apt install ros-noetic-PACKAGE
    sudo apt install ros-noetic-slam-gmapping

To find available packages, see ROS Index or use:

apt search ros-noetic

Environment setup

You must source this script in every bash terminal you use ROS in.

source /opt/ros/noetic/setup.bash

It can be convenient to automatically source this script every time a new shell is launched. These commands will do that for you.


If you have more than one ROS distribution installed, ~/.bashrc must only source the setup.bash for the version you are currently using.

echo "source /opt/ros/noetic/setup.bash" >> ~/.bashrc
source ~/.bashrc


echo "source /opt/ros/noetic/setup.zsh" >> ~/.zshrc
source ~/.zshrc


Now, to test your installation, please proceed to the ROS Tutorials.

2024-07-13 13:18