= Gentoo install of ROS Kinetic =

We are automatically generating the Ebuilds for Gentoo. Please note that there are also packages available from the Gentoo developers, but those packages are incomplete. Also note that these are being automatically generated from the rosdistro file, and there
are a number of unresolved dependencies for some packages.

Should your package fail to emerge, please report an issue on [[https://github.com/ros/ros-overlay|the ros-overlay repo]].

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

{{{{#!wiki important
'''If you rely on these packages, please support OSRF.'''

These ebuilds are generated and hosted on infrastructure maintained and paid for by the [[http://www.osrfoundation.org|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 [[https://events.osrfoundation.org/?page=CiviCRM&q=civicrm/contribute/transact&reset=1&id=3|donating to OSRF today]].
}}}}

<<TOC(3)>>

=== Installation ===
First, set the following in `/etc/portage/profile/eapi`.
{{{
6
}}}

Next, you need to add the ros-overlay sources to your emaint configuration.
{{{
# mkdir /etc/portage/repos.conf
}}}

Add the following to the file `/etc/portage/repos.conf/ros-overlay.conf`
{{{
[ros-overlay]
location = /usr/local/portage
sync-type = git
sync-uri = https://github.com/ros/ros-overlay
auto-sync = yes
masters = gentoo
}}}

Then synchronize the repository.
{{{
# emaint sync -r ros-overlay
}}}

{{{{#!wiki important
While Python 3 works for most of the libraries in ROS, there are still many components that rely on Python 2, making it the recommended choice for installation.

This implies you'll need to use '''eselect python''' to choose Python2.7 and add to '''/etc/portage/package.use''':

{{{
ros-kinetic/* PYTHON_TARGETS: -* python2_7
ros-kinetic/* PYTHON_SINGLE_TARGET: -* python2_7
}}}
}}}}

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, navigation and 2D/3D perception
   {{{
# emerge ros-kinetic/desktop_full --ask
}}}

 '''Desktop Install: ''' ROS, [[rqt]], [[rviz]], and robot-generic libraries
    {{{
# emerge ros-kinetic/desktop --ask
 }}}

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

   {{{
# emerge ros-kinetic/ros_base
}}}


 '''Individual Package:''' You can also install a specific ROS package:
{{{
# emerge ros-kinetic/PACKAGE
}}} e.g.
{{{
# emerge ros-kinetic/slam_gmapping
}}}

To find available packages, use:
{{{
ls /usr/local/portage/ros/ros-kinetic
}}}

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

=== 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 Gentoo, run:

{{{
# emerge dev-python/rosinstall
}}}

=== Build farm status ===

{{{#!wiki important
todo!
}}}

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