[Documentation] [TitleIndex] [WordIndex

Fedora Installation Instructions

SVN Based Install (download-and-compile)

Setup

sudo yum groupinstall 'Development Tools'
sudo yum install wget cmake PyYAML python-setuptools-devel
sudo yum install mercurial

rosinstall

The following lines will download the ROS source code using the rosinstall tool, and bootstrap the installation. The installation downloads all ROS stacks in subdirectories inside the ~/ros directory, one subdirectory for each stack in the rosinstall file.

First install rosinstall using pip (advanced options for pip):

  • sudo pip install -U rosinstall vcstools

There are many different libraries and tools in ROS. We provided four default configurations to get you started.

  • Desktop-Full Install: (Recommended): ROS Full, rviz, robot-generic libraries, 2D/3D simulators, navigation and 2D/3D perception

    • rosinstall ~/ros "http://packages.ros.org/cgi-bin/gen_rosinstall.py?rosdistro=electric&variant=desktop-full&overlay=no"

    Desktop Install: : ROS Full, rviz, and robot-generic libraries

    • rosinstall ~/ros "http://packages.ros.org/cgi-bin/gen_rosinstall.py?rosdistro=electric&variant=desktop&overlay=no"

    ROS-Full: ROS package, build, communication, and graphical tools.

    • rosinstall ~/ros "http://packages.ros.org/cgi-bin/gen_rosinstall.py?rosdistro=electric&variant=ros-full&overlay=no"

    ROS-Base: (Bare Bones) ROS package, build, and communication libraries.

    • rosinstall ~/ros "http://packages.ros.org/cgi-bin/gen_rosinstall.py?rosdistro=electric&variant=ros-base&overlay=no"

NOTE: the instructions above download all stacks inside the ~/ros folder. If you prefer a different location, simply change the ~/ros in the commands above.

Please reference REP 113 for description of other available configurations.

Environment Setup

Shell language:   Bash     Zsh    

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

source ~/ros/setup.bash

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.bash" >> ~/.bashrc
. ~/.bashrc

For Zsh users, change the last line of ~/ros/setup.zsh to

source $ROS_ROOT/tools/rosbash/roszsh

before running source ~/ros/setup.zsh Similarly, have the setup script called at the start of each new shell session with

echo "source ~/ros/setup.zsh" >> ~/.zshrc
. ~/.zshrc

Fixing Depency Installation Failure

If any dependencies are missing, the installation will abort because some code in rosdep is missing in the release version (1.6.2 at least). The error message will contain AttributeError: Fedora instance has no attribute 'installers'. After it fails, do the following (adjust initial change directory command to actual install path):

cd ~/ros
cd ros/tools/rosdep/src/rosdep/
svn merge -c 15179 https://code.ros.org/svn/ros/stacks/ros/trunk/tools/rosdep/src/rosdep/installers.py installers.py
svn merge -c 15179 https://code.ros.org/svn/ros/stacks/ros/trunk/tools/rosdep/src/rosdep/redhat.py redhat.py

Now run the installation command again exactly the same way you did before. This time the installation will succeed and any missing dependencies will be installed. Make sure you have sudo configured properly!

Tutorials

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


2024-12-21 14:54