README.md

ros2_setup_scripts_ubuntu

unofficial ROS2 install script for Ubuntu

Access https://index.ros.org/doc/ros2/Installation/ to get the updated information.

ROS 1 version: https://github.com/Tiryoh/ros_setup_scripts_ubuntu

QuickStart

After downloading this repository, just run the following command.

./run.sh

Usage

By default, run.sh will install ros-humble-desktop.
If you need to install another package, edit line8-9 in run.sh.

CHOOSE_ROS_DISTRO=humble # or foxy, etc...
INSTALL_PACKAGE=desktop # or ros-base

For example, if you want to install ros-base package of ROS 2 Foxy, edit like the followings.

CHOOSE_ROS_DISTRO=foxy # or foxy, etc...
INSTALL_PACKAGE=ros-base # or ros-base

After editing, run run.sh to install the packages.

./run.sh

Individual installers

In addition, there are other ways to use the installers.

ROS 2 Foxy

• To install ros-foxy-ros-base, use ros2-foxy-ros-base-main.sh instead of run.sh.
• To install ros-foxy-desktop, use ros2-foxy-desktop-main.sh instead of run.sh.

ROS 2 Humble

• To install ros-humble-ros-base, use ros2-humble-ros-base-main.sh instead of run.sh.
• To install ros-humble-desktop, use ros2-humble-desktop-main.sh instead of run.sh.

ROS 2 Dashing (EOL)

• To install ros-dashing-ros-base, use ros2-dashing-ros-base-main.sh instead of run.sh.
• To install ros-dashing-desktop, use ros2-dashing-desktop-main.sh instead of run.sh.

ROS 2 Eloquent (EOL)

• To install ros-eloquent-ros-base, use ros2-eloquent-ros-base-main.sh instead of run.sh.
• To install ros-eloquent-desktop, use ros2-eloquent-desktop-main.sh instead of run.sh.

ROS 2 Galactic (EOL)

• To install ros-galactic-ros-base, use ros2-galactic-ros-base-main.sh instead of run.sh.
• To install ros-galactic-desktop, use ros2-galactic-desktop-main.sh instead of run.sh.

Supported LTS Versions

Reference: REP-0003, REP-2000

Ubuntu	ROS 1	ROS 2
Ubuntu 18.04 EOL: May 2023	Melodic EOL: May 2023	Dashing EOL: May 2021
Ubuntu 20.04 EOL: May 2025	Noetic EOL: May 2025	Foxy EOL: May 2023
Ubuntu 22.04 EOL: May 2027	-	Humble EOL: May 2027

LICENSE

Copyright 2019-2023 Tiryoh

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Acknowledgements

run.sh is based on https://index.ros.org/doc/ros2/Installation/Crystal/Linux-Install-Debians/ by Open Robotics, licensed under CC-BY-4.0.

tutorial.sh is based on https://index.ros.org/doc/ros2/Tutorials/Colcon-Tutorial/ by Open Robotics, licensed under CC-BY-4.0.

source: https://github.com/ros2/ros2_documentation