ROS with Debian Stretch on the BeagleBone Black/Green/Blue

ROS, Debian Stretch and BeagleBone 3 minutes read

In this blog post, you will learn how to install ROS core on the BeagleBone Black/Green/Blue.

For demonstration purposes, I will use the Machinekit Debian Stretch image as a base. If you haven’t read my blog post about why Machinekit and ROS would be a great combo, I encourage you to read it later.

Although the BeagleBone Blue is designed for robotics, I couldn’t find any recent description on how to install ROS. Luckily, Michael Haberler created a Gist for installing ROS on the BeagleBone with Debian Jessie. I adapted this script for Debian Stretch and ROS kinetic.

Prepare a base image

First of all, start by downloading, flashing and installing the latest RCN Machinekit Debian Stretch image from here: BBB Machinekit Image with Debian Stretch

If you need some help flashing and installing the image on your BeagleBone please take a look at the first few steps of my blog post about Machinekit and Debian Stretch on the BeagleBone Black.

All the following commands will be executed on the BeagleBone itself.

Setup ROS repositories

Next, we need to add the ROS repositories.

sudo sh -c 'echo "deb stretch main" > /etc/apt/sources.list.d/ros-latest.list'
wget  -O - | sudo apt-key add -

Then we need to update the package source and upgrade the installed packages.

sudo apt-get update
sudo apt-get upgrade

Install basic ROS dependencies

Once the ROS repository is ready, we can continue by installing the ROS dependencies.

sudo apt-get install python-pip python-setuptools python-yaml python-distribute python-docutils python-dateutil python-six
sudo pip install rosdep rosinstall_generator wstool rosinstall

The following packages need to be installed as well to circumvent missing dependencies during installation.

sudo apt-get install \
     libconsole-bridge-dev liblz4-dev checkinstall cmake \
     python-empy python-nose libbz2-dev \
     libboost-test-dev libboost-dev  libboost-program-options-dev \
     libboost-regex-dev libboost-signals-dev \
     libtinyxml-dev libboost-filesystem-dev libxml2-dev \

And finally, we setup rosdep.

sudo rosdep init
rosdep update

Preparing the ROS build

Next, we need to tell the ROS build tool which packages we want to build and install. In this tutorial, we only install the basic ROS core tools. Feel free to extend the package selection with any additional package you require.

mkdir ~/ros_catkin_ws
cd ~/ros_catkin_ws

rosinstall_generator ros_comm --rosdistro kinetic --deps --wet-only --exclude roslisp --tar > kinetic-ros_comm-wet.rosinstall
wstool init src kinetic-ros_comm-wet.rosinstall

Additionally, before we can start the build, we need to make sure there is enough swap space available on the BeagleBone. This is easiest ensured by mounting an external USB drive.

# roscpp fails with oom error
# I added 4GB USB flash as swap space
sudo blkid
sudo mkswap /dev/XXX
sudo swapon /dev/XXX

Make sure to replace XXX with the device descriptor ID of your USB flash drive, e.g. sda1.

Install ROS dependencies

The ROS build tool can automatically resolve all dependencies of a ROS workspace. This works especially well if the ROS distribution supports the target operating system.

rosdep install --from-paths src --ignore-src --rosdistro kinetic -y -r --os=debian:stretch

The command may take a while to execute.

Build ROS

Now, that we have everything installed, we can continue by building and installing ROS. Note that this step takes a couple of hours on the BeagleBone.

sudo ./src/catkin/bin/catkin_make_isolated --install -DCMAKE_BUILD_TYPE=Release --install-space /opt/ros/kinetic

Alternatively, we could run this compilations step from cross-compile toolchain on a desktop computer. I will extend this guide at a later time to cover this step.

Source the ROS installation and get started

Once everything is installed, you can source the ROS workspace using the following command:

source /opt/ros/kinetic/

Now it’s time to follow the ROS tutorials.


In this short guide, you learned how to compile and install ROS Kinetic on the BeagleBone.

If you are looking for a compiled down version of the installation steps, please take a look at my Gist.

I hope you found this information useful.

Happy ROS hacking!

Machine Koder

Spread the love

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.