MobileRobot is a course repository designed for students and researchers exploring mobile robotics. It provides automated shell scripts and Docker-based workflows to get a fully configured ROS2 Humble environment running on Ubuntu 22.04 — covering everything from locale setup and package sources to a ready-to-buildDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/xXThanatosXx/MobileRobot/llms.txt
Use this file to discover all available pages before exploring further.
colcon_ws workspace.
Introduction
Learn what MobileRobot covers and how the repository is organized.
Quickstart
Get a working ROS2 Humble environment in minutes with the install scripts.
Native Ubuntu Install
Step-by-step ROS2 Humble installation on Ubuntu 22.04 using automated scripts.
Docker Install
Run ROS2 Humble inside a Docker container — ideal for Windows and macOS hosts.
What’s Included
ros2_install.sh
Automates locale setup, APT sources, ROS2 Humble desktop installation, and colcon workspace creation.
install_ros_packages.sh
Installs Gazebo, ros2-control, tf2, PlotJuggler, joystick teleop, and more.
Docker Image
Pre-built
xxthanatosxx/ros2-humble:1.0.0 image on Docker Hub for instant deployment.Getting Started
Prepare your system
Install Ubuntu 22.04 on VMware Workstation Player 17 or use Docker on any host OS. See Native Ubuntu Install or Docker Install.
Run the ROS2 installer
Download
ros2_install.sh, make it executable, and run it. The script handles locale, APT sources, package installation, and workspace creation automatically.Install additional ROS2 packages
Run
install_ros_packages.sh to add Gazebo, ros2-control, tf2, PlotJuggler, and other course packages.The scripts configure
~/.bashrc automatically with source /opt/ros/humble/setup.bash, ROS_DOMAIN_ID=0, and colcon shell completion. Open a new terminal or run source ~/.bashrc after installation to apply the changes.