Note: This tutorial assumes that you have completed the previous tutorials: Interacting with your Turtlebot.
(!) Please ask about problems and questions regarding this tutorial on Don't forget to include in your question the link to this page, the versions of your OS & ROS, and also add appropriate tags.

Turtlebot Installation

Description: Installing software onto the turtlebot.

Keywords: turtlebot installation

Tutorial Level: BEGINNER

Next Tutorial: PC Installation

Installation Types

The indigo turtlebot software is designed to run on a notebook running a Trusty version of Ubuntu. This is not a strict requirement - it will also be perfectly happy sitting on certain embedded boards, or source installed on top of another linux distribution but of course. If you wish to be more adventurous in this way, good luck!

ISO Installation

This instruction is for users with a netbook with no operating system.

Download ISO & Create Startup USB

Download TurtleBot ISO with the following link and create startup USB disk using Startup Disk Creator or similar tools.

Install Ubuntu with TurtleBot ISO

Boot from turtlebot ISO usb and follow normal ubuntu installer guide. This will also install turtlebot packages with fancy turtlebot background image.

Debs Installation

These instructions are intended for users with a netbook pre-installed with Ubuntu Trusty.

Ubuntu Repo Setup

Follow the generic Ubuntu instructions for a ros-indigo-desktop-full installation.

Ubuntu Package Install

In addition, you will need to install the following debs for TurtleBot (please update this if you find any errors):

> sudo apt-get install ros-indigo-turtlebot ros-indigo-turtlebot-apps ros-indigo-turtlebot-interactions ros-indigo-turtlebot-simulator ros-indigo-kobuki-ftdi ros-indigo-rocon-remocon ros-indigo-rocon-qt-library ros-indigo-ar-track-alvar-msgs

Source Installation

This is for people who'd like to hack on the turtlebot sources and contribute. For more information, please ask us for more information at <ros-sig-turtlebot AT googlegroups DOT com>.


> sudo apt-get install python-rosdep python-wstool ros-indigo-ros
> sudo rosdep init
> rosdep update


We are using chained workspaces here, but you could just as simply merge them into one.

> mkdir ~/rocon
> cd ~/rocon
> wstool init -j5 src
> source /opt/ros/indigo/setup.bash
> rosdep install --from-paths src -i -y
> catkin_make

> mkdir ~/kobuki
> cd ~/kobuki
> wstool init src -j5
> source ~/rocon/devel/setup.bash
> rosdep install --from-paths src -i -y
> catkin_make

> mkdir ~/turtlebot
> cd ~/turtlebot
> wstool init src -j5
> source ~/kobuki/devel/setup.bash
> rosdep install --from-paths src -i -y
> catkin_make


If you are having conflict issues with openni sensor debs, please read this issue to find a workaround.

If the rosdep install step for ~/turtlebot fails saying it's unable to find create_dashboard and create_gazebo_plugins, make sure you use '-r' with the rosdep install command and that will continue despite not being able to find either create_dashboard or create_gazebo_plugins.

Post Installation

Environment variables

For Turtlebot packages some environment variables are used that are set by environment hook. Most easily, it's automatically run when you open a new terminal.

Base-Specific Instructions

  • Kobuki Base - instructions for transferring a udev rule to conveniently work with the Kobuki.

  • Create Base - instructions for modifying the turtlebot software to work with the Create.

Alternative Hardware Options


For convenience, you may wish to source your script from your .bashrc so that your environment is ready as soon as you log in. e.g.

# For a deb installation
> echo "source /opt/ros/indigo/setup.bash" >> ~/.bashrc
# For a source installation
> echo "source ~/turtlebot/devel/setup.bash" >> ~/.bashrc

If you have overlaid your own development environment on top of the installed debs, point to that setup script instead.

What Next?

Wiki: turtlebot/Tutorials/indigo/Turtlebot Installation (last edited 2016-08-18 23:36:37 by KevinWells)