[Documentation] [TitleIndex] [WordIndex

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 the ros-overlay repo.

If you need to install from source (not recommended), please see source (download-and-compile) installation instructions.

If you rely on these packages, please support OSRF.

These ebuilds are generated 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.


First, set the following in /etc/portage/profile/eapi.


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

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

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 ros-shadow-fixed

# emerge ros-kinetic/PACKAGE


# 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



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

2024-06-15 12:57