[Documentation] [TitleIndex] [WordIndex

Gentoo Linux Installation Instructions (experimental)

SVN Based Install (download-and-compile)


sudo mkdir -p /etc/portage
sudo bash -c 'echo app-portage/gentoolkit >> /etc/portage/package.keywords'
sudo emerge -u pyyaml cmake subversion gentoolkit

rosinstall (OS-neutral)

The rosinstall tool can now install a configuration of ROS on your machine. The following lines will download the ROS source code, and bootstrap the installation. The sample configuration used below will place everything in subdirectories inside the ~/ros directory, one subdirectory for each entry in the rosinstall file. This will take a while, but it should be fully automated once the initial system dependencies are installed by the rosdep tool.

wget --no-check-certificate http://ros.org/rosinstall -O ~/rosinstall
chmod 755 ~/rosinstall

You now need to rosinstall to install using a configuration file. We've created the following configurations:

  • "base" (robot-generic)
  • "pr2" (PR2 robot development)

The rosinstall format is just a list of SVN repositories, so it's easy to create your own (see rosinstall for more information on this format).

NOTE: the instructions below assume you are installing to ~/ros. To change this location, simply change the ~/ros in the commands below.

  • ROS-only: Includes basic ROS and tutorials.

    ~/rosinstall ~/ros http://ros.org/rosinstalls/boxturtle_ros.rosinstall 

    Base Install: Recommended, includes ROS, robot-generic libraries, and tutorials.

    ~/rosinstall ~/ros http://ros.org/rosinstalls/boxturtle_base.rosinstall

    PR2 Install: Includes ROS, robot-generic libraries, tutorials, and PR2-specific libraries.

    ~/rosinstall ~/ros http://ros.org/rosinstalls/boxturtle_pr2.rosinstall

Environment Setup

You'll now need to update your environment. You can do this by typing:

source ~/ros/setup.sh

It's convenient if the ROS environment variables are automatically added to your bash session every time a new shell is launched, which you can do with the command below:

echo "source ~/ros/setup.sh" >> ~/.bashrc
. ~/.bashrc



To install the tutorials you will need at least boxturtle-base installed before running the following, with it setup in your environment. Go back to boxturtle/Installation if you have not installed boxturtle-base.


If you are using binary installs.

. /opt/ros/boxturtle/setup.sh

If you are using a source install

. ~/ros/setup.sh

Install tool

  • wget --no-check-certificate http://ros.org/rosinstall -O ~/rosinstall
    chmod 755 ~/rosinstall
    ~/rosinstall -o ~/ros-tutorials http://rosinstalls/ros_boxturtle_tutorial.rosinstall

You'll need to configure your environment to enable the tutorials, just like you did with the ROS installation. The command below will automatically load the environment variables in your bash shell:

echo "source ~/ros-tutorials/setup.sh" >> ~/.bashrc
. ~/.bashrc

If you just want to change the environment of your current shell, you can type:

source ~/ros-tutorials/setup.sh

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

2021-01-02 12:32