Install supported ROS-2 distribution

By clicking the image,  you can go to the installation procedure of the respective ROS distro.


Rolling distro, is specific for the developers and there are chances to find code that breaks your process. Using Rolling distro is encouraged, only if you are developing a package based on this simulation, else use other distros. 

Create workspace

ROS-2 does not use catkin for building the package unlike ROS-1, rather it uses ament_cmake as the default!

Follow this link to create a colcon workspace https://docs.ros.org/en/foxy/Tutorials/Colcon-Tutorial.html

Before continuing with this tutorial, make sure you have sourced your corresponding ROS-Distro

Automated workspace setup

  1. Download this file to your directory where you want to setup your workspace (usually the /home/$USER)

    Download the setup script here: setup-2.sh


  2. Make the downloaded file as an executable using:

    chmod +x /setup-2.sh


  3. Just run the downloaded script from that particular directory to install all our packages:

    ./setup-2.sh


Manual workspace setup

Installing the package

There are two ways to do it

1. Clone neo_simulation2 into your workspace


Please checkout to your $ROS_DISTRO branch – We provide support to all the currently active ROS2 distribution.


cd your_colcon_workspace/src
git clone https://github.com/neobotix/neo_simulation2.git
cd ..
colcon build --symlink-install


2. Install as binaries


Only available for Rolling and Galactic. For Foxy clone the package into your_colcon_workspace as described as above


sudo apt-get install ros-$ROS_DISTRO-neo-simulation2


Sourcing the workspace


echo "source your_colcon_workspace/install/setup.bash" >> ~/.bashrc


Install the relevant ROS-2 Gazebo Packages


sudo apt-get install ros-$ROS_DISTRO-gazebo-ros ros-$ROS_DISTRO-gazebo-plugins ros-$ROS_DISTRO-gazebo-ros-pkgs


Install the ROS-2 Navigation Packages


Only available for Foxy and Galactic. For Rolling, follow the steps shown in the link: https://navigation.ros.org/build_instructions/index.html (section: For main branch development)


sudo apt install ros-$ROS_DISTRO-navigation2 ros-$ROS_DISTRO-nav2-bringup


Clone the neo_local_planner and build it


Please checkout to your $ROS_DISTRO branch – We provide support to all the currently active ROS2 distribution.


cd to_your_workspace/src
git clone https://github.com/neobotix/neo_local_planner2.git
cd ..
colcon build --symlink-install


Install the ROS-2 SLAM Toolbox


sudo apt install ros-foxy-slam-toolbox