--- title: "\uFEFFSimulate the TurtleBot3" description: Get started in robotics by trying out an open source simulator! The TurtleBot3 simulator comes complete with LIDAR, a camera, a gyro and many other sensors. url: https://canonical.com/blog/simulate-the-turtlebot3?format=md --- 1. [Blog](https://canonical.com/blog) 2. Article --- [sidfaber](https://canonical.com/blog/author/sidfaber "More about sidfaber") 24 July 2020 # Simulate the TurtleBot3 [containers](https://canonical.com/blog/tag/containers) [Foxy](https://canonical.com/blog/tag/foxy) [Gazebo](https://canonical.com/blog/tag/gazebo) [LXD](https://canonical.com/blog/tag/lxd) [robotics](https://canonical.com/blog/tag/robotics) [Robotis](https://canonical.com/blog/tag/robotis) [Robots](https://canonical.com/blog/tag/robots) [ROS](https://canonical.com/blog/tag/ros) [ROS2](https://canonical.com/blog/tag/ros2) [Simulation](https://canonical.com/blog/tag/simulation) --- Share the article > Please note that this blog post has old information that may no longer be correct. We invite you to read the content as a starting point but please search for more updated information in the [ROS documentation](https://docs.ros.org/). Interested in getting started in robotics? There’s no need to purchase expensive hardware before you try some things out: simulate a TurtleBot3 instead! The simulator is complete with LIDAR, a camera, a gyro and many other sensors and actuators. You can also see this installation in action at the [Ubuntu Robotics YouTube channel](https://www.youtube.com/channel/UCsVzQYenRLqPf_4IjR-moLw). Software used for the simulation includes the robot operating system (ROS), a simulation framework (Gazebo) and the robot software (TurtleBot). * The [Robot Operating System](https://www.ros.org/) (ROS) provides the fundamental framework for interacting with hardware and overall control of the robot. * The [Gazebo simulator](http://gazebosim.org/) emulates robot hardware in software to provide input to ROS. * The [TurtleBot 3 WafflePi from Robotis](http://www.robotis.us/turtlebot-3/) software includes ROS code to run the robot and configuration files for Gazebo. We intend to install on Foxy (the latest LTS ROS release), which drives the version requirements for the rest of the installation: Ubuntu 20.04 Focal, Gazebo 11, and the ROS 2 installation of TurtleBot3. # **Install ROS** This simulator requires a standard installation of ROS Foxy. While ROS can be installed directly on a Linux workstation, it can also be installed in a container or a virtual machine dedicated to the simulator. If you followed instructions to [install ROS in an LXD Container](https://youtu.be/bFJp7WAfcXk), use the following commands to launch a container: ``` lxc launch -p ros ubuntu:20.04 turtlebot lxc ubuntu turtlebot ``` Install ROS Foxy Desktop and set up the ROS environment in your Ubuntu container. ``` sudo apt install ros-foxy-desktop source /opt/ros/foxy/setup.bash echo "source /opt/ros/foxy/setup.bash" >> ~/.bashrc ``` Install the colon build tool as well. This allows us to build the TurtleBot software on your workstation. ``` sudo apt install python3-colcon-common-extensions ``` # **Install Gazebo** Robot simulation is challenging. All the necessary actuators and sensors must provide readings to behave like the real world. Generic hardware must be tailored for each specific robot. Thankfully Robotis provides all the necessary configuration data to simulate the TurtleBot hardware. We’ll follow the [TurtleBot3 ROS 2 PC Setup instructions](https://emanual.robotis.com/docs/en/platform/turtlebot3/ros2_setup/#install-ros-2-dependent-packages). As of this writing the Robotis instructions still follow ROS Dashing. The installation for Foxy is straight forward, simply install Gazebo 11 and the associated ROS meta-package: ``` sudo apt install gazebo11 ros-foxy-gazebo-ros-pkgs ``` You may also choose to install additional software to explore some of the more advanced ROS features.  To enable the robot to map its local environment, install [cartographer for simultaneous localization and mapping (SLAM)](http://wiki.ros.org/cartographer). To experiment with robot movement in a real world, install the [Navigation Stack for ROS 2](https://navigation.ros.org/): ``` sudo apt install ros-foxy-cartographer sudo apt install ros-foxy-cartographer-ros sudo apt install ros-foxy-navigation2 sudo apt install ros-foxy-nav2-bringup ``` # **Install TurtleBot3** Next we will install the TurtleBot by downloading source files, compiling, and installing the software. Use the vcstool utility and use it to download software from the necessary software repositories. ``` sudo apt install python3-vcstool mkdir -p ~/turtlebot3_ws/src cd ~/turtlebot3_ws wget https://raw.githubusercontent.com/ROBOTIS-GIT/turtlebot3/ros2/turtlebot3.repos vcs import src < turtlebot3.repos ``` Now that the source code has been downloaded from the repository, compile using the standard syntax for the colcon build tool. ``` colcon build --symlink-install ``` As always, source the ROS setup file to add the newly installed executables to the environment. ``` echo 'source ~/turtlebot3_ws/install/setup.bash' >> ~/.bashrc ``` Although the software has been installed, two environment variables must also be configured. Set the `GAZEBO_MODEL_PATH` variable to let Gazebo find the TurtleBot model definition files. Set the `TURTLEBOT3_MODEL` to `waffle_pi` to simulate the TurtleBot3 Waffle Pi. After adding these lines to your `.bashrc` file, source the file. ``` echo 'export GAZEBO_MODEL_PATH=$GAZEBO_MODEL_PATH:~/turtlebot3_ws/src/turtlebot3/turtlebot3_simulations/turtlebot3_gazebo/models' >> ~/.bashrc echo 'export TURTLEBOT3_MODEL=waffle_pi' >> ~/.bashrc source ~/.bashrc ``` # **Launch the simulator** All the necessary software has been installed and configured, so we’re ready to launch the simulator. Following the [TurtleBot 3 simulation instructions](https://emanual.robotis.com/docs/en/platform/turtlebot3/ros2_simulation/#ros-2-simulation) for Gazebo, issue the launch command. ``` ros2 launch turtlebot3_gazebo empty_world.launch.py ``` The first launch argument–the package name–runs the gazebo simulation package. The second argument specifies the launch file to use from the package. Explore the simulation you just launched! Change the simulation by launching with different worlds such as `turtlebot3_house.launch.py` or `turtlebot3_world.launch.py`. Use ROS commands from any computer on the same network to explore your simulator: ``` ros2 topic list ros2 service list ros2 topic pub /cmd_vel geometry_msgs/Twist '{linear: {x: 1.0}}' -1 ros2 topic pub /cmd_vel geometry_msgs/Twist '{linear: {x: 0.0}}' -1 ros2 run turtlebot3_teleop teleop_keyboard ``` If you try to control a simulated TurtleBot3 from another machine and it doesn’t seem to be working, check the `ROS_DOMAIN_ID` environment variable. By default ROS uses the domain 0, but the TurtleBot instructions typically configure it for 30. Consider adding setting the domain to 30 for all of your hosts connecting to the TurtleBot: ``` echo 'export ROS_DOMAIN_ID=30' >> ~/.bashrc source ~/.bashrc ``` ## Sign up for our newsletter Get the latest Canonical news and updates in your inbox. Work email: \*I agree to receive information about Canonical's products and services. By submitting this form, I confirm that I have read and agree to [Canonical's Privacy Policy](https://canonical.com/legal/dataprivacy). Sign up ## Share on --- ## Related posts [### Extending ROS Noetic Support with ESM-Enabled Content Snaps](https://canonical.com/blog/extending-ros-noetic-support-with-esm-enabled-content-snaps) Canonical has now extended its ESM (Expanded Security Maintenance) for ROS coverage to ROS Noetic content-sharing snaps. With ESM for ROS now available in both deb and snap... [Florencia Cabral Berenfus](https://canonical.com/blog/author/flor-cabral) 17 December 2025 [### Discover your fully open source robotics observability at ROSCon 2025](https://canonical.com/blog/roscon-2025) Another year, another ROSCon! This year we’re heading to Singapore, and Canonical is once again thrilled to sponsor this important community event. Just like last year in... [Gabriel Aguiar Noury](https://canonical.com/blog/author/g-aguiar-noury) 22 October 2025 [### Canonical is now a platinum member in the Open Source Robotics Alliance](https://canonical.com/blog/osra-membership) Ubuntu is the home of ROS. The very first ROS distribution, Box Turtle, launched on Ubuntu 8.04 LTS, Hardy Heron, and since then, Ubuntu and ROS have grown hand in hand. With... [Gabriel Aguiar Noury](https://canonical.com/blog/author/g-aguiar-noury) 20 August 2025 [### ROS Noetic is EOL – take action to maintain fleet security](https://canonical.com/blog/ros-noetic-is-eol-take-action-to-maintain-fleet-security) As of May 2025, the Robot Operating System (ROS) Noetic Ninjemys officially reached its end of life (EOL). First released in 2020 as the final ROS (1) distribution, ROS Noetic... [Florencia Cabral Berenfus](https://canonical.com/blog/author/flor-cabral) 8 August 2025