Edit on GitHub

PC Software Setup

Warning : The contents in this chapter corresponds to the Remote PC (your desktop or laptop PC) which will control TurtleBot3. Do NOT apply this instruction to your TurtleBot3.

Note : This instruction was tested on Ubuntu 16.04 and ROS Kinetic Kame.

Install Ubuntu on Remote PC (Desktop or Laptop PC)

[Remote PC] Download Ubuntu 16.04 on the remote PC from the following link.

If you need more help for installing Ubuntu, check out the step-by-step guide from the link below.

Install ROS on Remote PC

[Remote PC] There are two ways to install ROS. If you prefer manual installation, please take the second method. In order to develop source code from the remote PC, please configure ROS environment after completing ROS installation.

First Method

Install ROS by using a simple installation script file

Tip : The terminal application can be found with the Ubuntu search icon on the top left corner of the screen. Shortcut key for terminal is Ctrl-Alt-T.

  sudo apt-get update
  sudo apt-get upgrade
  wget https://raw.githubusercontent.com/ROBOTIS-GIT/robotis_tools/master/install_ros_kinetic.sh && chmod 755 ./install_ros_kinetic.sh && bash ./install_ros_kinetic.sh

Second Method

You can start from “1.2 Setup your sources.list” and keep following the instruction until “1.7 Getting rosinstall” from below ROS installation instruction link.

Note : In order to check which packages are installed, please check this link out. https://raw.githubusercontent.com/ROBOTIS-GIT/robotis_tools/master/install_ros_kinetic.sh

Configure ROS Environment

If you are going to modify or develop source code from the remote PC, you’ll have to configure ROS environment. Simple instructions are described in the below link and it will take a couple minutes.

Install Dependent packages

[Remote PC] The next step is to install dependent packages for TurtleBot3 control.

  sudo apt-get install ros-kinetic-joy ros-kinetic-teleop-twist-joy ros-kinetic-teleop-twist-keyboard ros-kinetic-laser-proc ros-kinetic-rgbd-launch ros-kinetic-depthimage-to-laserscan ros-kinetic-rosserial-arduino ros-kinetic-rosserial-python ros-kinetic-rosserial-server ros-kinetic-rosserial-client ros-kinetic-rosserial-msgs ros-kinetic-amcl ros-kinetic-map-server ros-kinetic-move-base ros-kinetic-urdf ros-kinetic-xacro ros-kinetic-compressed-image-transport ros-kinetic-rqt-image-view ros-kinetic-gmapping ros-kinetic-navigation
  cd ~/catkin_ws/src/
  git clone https://github.com/ROBOTIS-GIT/turtlebot3_msgs.git
  git clone https://github.com/ROBOTIS-GIT/turtlebot3.git
  cd ~/catkin_ws && catkin_make

If catkin_make command is completed without any errors, the preparation for TurtleBot3 is done.

Network Configuration

ROS requires IP addresses in order to communicate between TurtleBot3 and the remote PC.

[Remote PC] Enter the below command on the terminal window of the remote PC to find out the IP address of the remote PC.


Text strings in the rectangle is the IP address of the Remote PC.

[Remote PC] Enter the below command.

  gedit ~/.bashrc

Modify the address of localhost with the IP address acquired from the above terminal window.

[Remote PC] Then, source the bashrc with below command.

  source ~/.bashrc