= Ubuntu install of ROS Jade =

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.

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

<<Include(SupportBuildfarm)>>

<<TOC(3)>>


== Installation ==

ROS Jade '''ONLY''' supports Trusty (14.04), Utopic (14.10) and Vivid (15.04) for debian packages.

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


=== Installation ===

First, make sure your Debian package index is up-to-date:
 {{{
sudo apt-get update
}}}
 {{{{{#!wiki background/blue
 If you are using Ubuntu Trusty '''14.04.2''' and experience dependency issues during the ROS installation, you may have to install some additional system dependencies.
  /!\ '''Do not install these packages if you are using 14.04, it will destroy your X server''':
  {{{
sudo apt-get install xserver-xorg-dev-lts-utopic mesa-common-dev-lts-utopic libxatracker-dev-lts-utopic libopenvg1-mesa-dev-lts-utopic libgles2-mesa-dev-lts-utopic libgles1-mesa-dev-lts-utopic libgl1-mesa-dev-lts-utopic libgbm-dev-lts-utopic libegl1-mesa-dev-lts-utopic
}}}
  /!\ '''Do not install the above packages if you are using 14.04, it will destroy your X server'''

 Alternatively, try installing ''just'' this to fix dependency issues:
   {{{
sudo apt-get install libgl1-mesa-dev-lts-utopic
}}}

For more information on this issue see this [[http://answers.ros.org/question/203610/ubuntu-14042-unmet-dependencies/|answers.ros.org thread]] or this [[https://bugs.launchpad.net/ubuntu/+source/mesa-lts-utopic/+bug/1424059|launchpad issue]]

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

 '''Desktop-Full Install: (Recommended)''' : ROS, [[rqt]], [[rviz]], robot-generic libraries, 2D/3D simulators, navigation and 2D/3D perception
 {{{#!wiki background/blue
Jade uses Gazebo '''5''' which is the default version of Gazebo and is recommended. If you would like to instead use a newer version of Gazebo (6 or 7), refer to [[http://gazebosim.org/tutorials?tut=ros_wrapper_versions|these instructions]] on the Gazebo site. Note that installing a newer version of Gazebo will require you to build dependent packages (such as `turtlebot_gazebo`) to be built from source. See also [[http://gazebosim.org/tutorials?tut=ros_wrapper_versions#UsingaspecificGazeboversionwithROS|Using a specific Gazebo version with ROS]].
}}}
    {{{
sudo apt-get install ros-jade-desktop-full
 }}} or [[apt:ros-jade-desktop-full?refresh=yes|click here]]

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

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

   {{{
sudo apt-get install ros-jade-ros-base
}}} or [[apt:ros-jade-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-get install ros-jade-PACKAGE
    }}} e.g.
    {{{
sudo apt-get install ros-jade-slam-gmapping
}}}

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

=== Initialize rosdep ===

Before you can use ROS, you will need to initialize `rosdep`. `rosdep` enables you to easily install system dependencies for source you want to compile and is required to run some core components in ROS.

    {{{
sudo rosdep init
rosdep update
}}}

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

=== Getting rosinstall ===

[[rosinstall]] is a frequently used command-line tool in ROS that is distributed separately.  It enables you to easily download many source trees for ROS packages with one command.

To install this tool on Ubuntu, run:

    {{{
sudo apt-get install python-rosinstall
}}}

=== Build farm status ===

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

<<Include(jade/Installation/PostInstall)>>
----
CategoryCategory