= Ubuntu install of ROS Melodic =

We are building Debian packages for several Ubuntu platforms, listed below. These packages are more efficient than source-based builds and are our preferred installation method for Ubuntu. Note that there are also packages available from Ubuntu upstream. Please see [[UpstreamPackages]] to understand the difference.

Ubuntu packages are built for the following distros and architectures. 

|| Distro || amd64 || arm64 || armhf ||
|| Artful || X ||   ||   ||
|| Bionic || X || X || X ||

If you need to install from source ('''not recommended'''), please see [[melodic/Installation/Source|source (download-and-compile) installation instructions]].

<<Include(SupportBuildfarm)>>

<<TOC(3)>>


== Installation ==

<<Include(Installation/Ubuntu/Sources)>>


=== Installation ===

First, make sure your Debian package index is up-to-date:
 {{{
sudo apt update
}}}

There are many different libraries and tools in ROS.  We provided four default configurations to get you started.  You can also install ROS packages individually.

In case of problems with the next step, you can use following repositories instead of the ones mentioned above [[http://wiki.ros.org/ShadowRepository|ros-shadow-fixed]]

 '''Desktop-Full Install: (Recommended)''' : ROS, [[rqt]], [[rviz]], robot-generic libraries, 2D/3D simulators and 2D/3D perception
    {{{
sudo apt install ros-melodic-desktop-full
 }}} or [[apt:ros-melodic-desktop-full?refresh=yes|click here]]

 '''Desktop Install: ''' ROS, [[rqt]], [[rviz]], and robot-generic libraries
    {{{
sudo apt install ros-melodic-desktop
 }}} or [[apt:ros-melodic-desktop?refresh=yes|click here]]

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

   {{{
sudo apt install ros-melodic-ros-base
}}} or [[apt:ros-melodic-ros-base?refresh=yes|click here]]


 '''Individual Package:''' You can also install a specific ROS package (replace underscores with dashes of the package name):
    {{{
sudo apt install ros-melodic-PACKAGE
    }}} e.g.
    {{{
sudo apt install ros-melodic-slam-gmapping
}}}

To find available packages, use:
{{{
apt search ros-melodic
}}}



<<Include(melodic/Installation/DebEnvironment)>>

<<Include(Installation/Ubuntu/BinariesBuildDependencies)>>

=== Build farm status ===

The packages that you installed were built by the [[http://build.ros.org|ROS build farm]].  You can check the status of individual packages [[http://repositories.ros.org/status_page/ros_melodic_default.html|here]].

<<Include(melodic/Installation/PostInstall)>>