turtlebot4_setup package from turtlebot4_setup repo


Package Summary

Tags No category tags.
Version 1.0.3
License Apache 2.0
Build type AMENT_CMAKE

Repository Summary

Checkout URI https://github.com/turtlebot/turtlebot4_setup.git
VCS Type git
VCS Version humble
Last Updated 2024-02-13
CI status No Continuous Integration
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Package Description

Turtlebot4 setup scripts

Additional Links

No additional links.


  • rkreinin


No additional authors.

Turtlebot4 Setup

Setup scripts and tools for the TurtleBot 4 Raspberry Pi.

Visit the TurtleBot 4 User Manual for more details.

Create an image manually

Follow these instructions if you wish to create a Turtlebot4 image manually.

Create an Ubuntu Image

First install the Raspberry Pi Imager.

  • Insert your SD card into your PC and run the Raspberry Pi Imager. Follow the instructions and install Ubuntu 22.04 Server (64-bit) onto the SD card.
  • Ensure your Raspberry Pi 4 is not powered before inserting the flashed SD card.
  • You can set up the Raspberry Pi by either connecting it to your network via Ethernet or by using a keyboard and HDMI monitor via a micro HDMI cable.

Ethernet Setup

  • Connect the Raspberry Pi to your Network with an Ethernet cable.
  • Boot the Raspberry Pi.
  • Find the Raspberry Pi's IP using your router's portal.
  • SSH into the Raspberry Pi using the IP address.
ssh ubuntu@xxx.xxx.xxx.xxx

  • The default login is ubuntu and password is ubuntu. You will be prompted to change your password.

HDMI Setup

  • Connect a keyboard to the Raspberry Pi via USB.
  • Connect a monitor to the Raspberry Pi via the HDMI0 port.
  • Boot the Raspberry Pi.
  • The default login is ubuntu and password is ubuntu. You will be prompted to change your password.

Manually configure Wi-Fi

Once you are logged into the Raspberry Pi, configure the Wi-Fi:

sudo nano /etc/netplan/50-cloud-init.yaml

Add the following lines:

        optional: true
                password: "YOUR_WIFI_PASSWORD"
        dhcp4: true

Note: Ensure that wifis: is aligned with the existing ethernets: line. All indentations should be 4 spaces. Do not use tabs. - Reboot the Raspberry Pi. It should now be connected to your Wi-Fi. - Find the Raspberry Pi's IP using your router's portal. - SSH into the Raspberry Pi using the IP address.

ssh ubuntu@xxx.xxx.xxx.xxx

Download and run the setup script

wget -qO - https://raw.githubusercontent.com/turtlebot/turtlebot4_setup/humble/scripts/turtlebot4_setup.sh | bash

The script will automatically install ROS 2 Humble, TurtleBot 4 packages, and other important apt packages. It will also configure the RPi4 to work in a TurtleBot 4. Once complete, the RPi4 should be rebooted with sudo reboot. Then, run turtlebot4-setup to configure the robot with the setup tool.


Changelog for package turtlebot4_setup

1.0.3 (2023-11-08)

  • Cleanup <https://github.com/turtlebot/turtlebot4_setup/issues/7>
  • Remove scripts that should not be used in Humble
  • Update create_update.sh to reference Humble minimum version
  • Updated README
  • Updated turtlebot4_setup.sh script
  • Fixed setting robot model
  • Contributors: Hilary Luo, Roni Kreinin

1.0.2 (2023-03-01)

  • Fixed Discovery Server IP
  • Updated default configs
  • Contributors: Roni Kreinin

1.0.1 (2023-02-28)

  • Fixed script install path
  • Contributors: Roni Kreinin

1.0.0 (2023-02-24)

  • turtlebot4_setup tool
  • RPI config updates
  • Discovery server files
  • Contributors: Roni Kreinin

0.1.3 (2022-09-27)

  • Merge pull request #2 from turtlebot/roni-kreinin/domain_id v0.1.3
  • Added webserver service
  • Added argparser to install.py Removed namespacing for now
  • Added \'ros_config\' script for setting ROS_DOMAIN_ID, namespace, and RMW_IMPLEMENTATION
  • Contributors: Roni Kreinin, roni-kreinin

0.1.2 (2022-06-14)

  • Added chrony Updated wifi script
  • Updated dependencies Move swap_on and swap_off to /usr/local/bin
  • Fixed comment
  • Updated Create 3 curl commands Move wifi and create update scripts to /usr/local/bin
  • Updated oakd branch
  • Update README.md
  • Moved contents to root folder Updated oakd script to work for both pro and lite Updated turtlebot4_setup script Updated wifi script to allow the create 3 to be set up through the pi Added create 3 firmware flash scripts
  • Update README.md
  • Updated robot_upstart repo
  • Added swap memory scripts when more RAM is needed to build packages
  • Updated README
  • Initial commit
  • Contributors: Roni Kreinin, roni-kreinin

Wiki Tutorials

See ROS Wiki Tutorials for more details.

Source Tutorials

Not currently indexed.

Dependant Packages

No known dependants.

Launch files

No launch files found


No message files found.


No service files found


No plugins found.

Recent questions tagged turtlebot4_setup at Robotics Stack Exchange