= Ubuntu install of ROS Hydro =
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 [[hydro/Installation/Source|source (download-and-compile) installation instructions]].

<<TOC(3)>>

== Installation ==
<<Include(hydro/Installation/Sources)>>

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

 . {{{
sudo apt-get 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.

NOTE: '''You may get a prompt about hddtemp when you do the install below''': you can safely answer no to the prompt if you are not installing on an actual PR2.

 . '''Desktop-Full Install: (Recommended)''' : ROS, [[rqt]], [[rviz]], robot-generic libraries, 2D/3D simulators, navigation and 2D/3D perception
  . {{{
sudo apt-get install ros-hydro-desktop-full
}}}
  or
  {{{#!rhtml
 <a href="apt:ros-hydro-desktop-full?refresh=yes" onClick="javascript: _gaq.push(['_trackPageview', '/downloads/map']);">click here</a>
}}}
 '''Desktop Install: ''' ROS, [[rqt]], [[rviz]], and robot-generic libraries
  . {{{
sudo apt-get install ros-hydro-desktop
}}}
  or
  {{{#!rhtml
 <a href="apt:ros-hydro-desktop?refresh=yes" onClick="javascript: _gaq.push(['_trackPageview', '/downloads/map']);">click here</a>
}}}
 '''ROS-Base: (Bare Bones)''' ROS package, build, and communication libraries. No GUI tools.
  . {{{
sudo apt-get install ros-hydro-ros-base
}}}
  or
  {{{#!rhtml
<a href="apt:ros-hydro-ros-base?refresh=yes" onClick="javascript: _gaq.push(['_trackPageview', '/downloads/map']);">click here</a>
}}}
 '''Individual Package:''' You can also install a specific ROS package (replace underscores with dashes of the package name):
  . {{{
sudo apt-get install ros-hydro-PACKAGE
}}}
   . e.g.
  {{{
sudo apt-get install ros-hydro-slam-gmapping
}}}

To find available packages, use:

{{{
apt-cache search ros-hydro
}}}
=== 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(hydro/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
}}}
<<Include(groovy/Installation/PostInstall)>>

----
CategoryCategory