ROS Install Scripts

Install any official ROS 1 or ROS 2 distribution on its canonical Ubuntu release with one command.

Quick start · Distributions · Variants · EOL support

---

Choose a ROS distribution and an installation variant. The installer validates the host Ubuntu release before making system changes.

Command	Ubuntu targets	Variants
./install.sh <distribution> <base|desktop>	10.04 Lucid Lynx through 26.04 Resolute Raccoon	base, desktop

Important

This is a community project. It is not an official ROS or Ubuntu installer.

Warning

EOL distributions and their Ubuntu releases receive no security fixes. Use them only when compatibility requires it, preferably in an isolated environment.

Quick start

Prerequisites

• The exact Ubuntu release listed for your ROS distribution
• sudo access and an internet connection
• The Ubuntu universe component enabled

On a current Ubuntu release, enable universe with:

sudo apt-get update
sudo apt-get install -y software-properties-common
sudo add-apt-repository -y universe

Clone the repository and make the installer executable:

git clone https://github.com/shkwon98/ros-install-scripts.git
cd ros-install-scripts
chmod +x install.sh

Install a distribution:

./install.sh jazzy desktop

Other examples:

./install.sh noetic base   # EOL ROS 1
./install.sh iron desktop # EOL ROS 2
./install.sh rolling base # Rolling Ridley

The installer does not edit your shell startup files. Use the command printed after installation:

source /opt/ros/<distribution>/setup.bash

Supported distributions

Each ROS distribution targets one canonical Ubuntu release. (LTS) marks long-term support releases. EOL entries are installed from their frozen final snapshot.

Ubuntu	ROS 1	ROS 2
10.04 Lucid Lynx	Box Turtle EOL  C Turtle EOL  Diamondback EOL  Electric Emys EOL	—
12.04 Precise Pangolin	Fuerte Turtle EOL  Groovy Galapagos EOL  Hydro Medusa EOL	—
14.04 Trusty Tahr	Indigo Igloo (LTS) EOL  Jade Turtle EOL	—
16.04 Xenial Xerus	Kinetic Kame (LTS) EOL  Lunar Loggerhead EOL	Ardent Apalone EOL
18.04 Bionic Beaver	Melodic Morenia (LTS) EOL	Bouncy Bolson EOL  Crystal Clemmys EOL  Dashing Diademata (LTS) EOL  Eloquent Elusor EOL
20.04 Focal Fossa	Noetic Ninjemys (LTS) EOL	Foxy Fitzroy (LTS) EOL  Galactic Geochelone EOL
22.04 Jammy Jellyfish	—	Humble Hawksbill (LTS)  Iron Irwini EOL
24.04 Noble Numbat	—	Jazzy Jalisco (LTS)  Kilted Kaiju
26.04 Resolute Raccoon	—	Lyrical Luth (LTS)  Rolling Ridley

Humble Hawksbill, Jazzy Jalisco, Kilted Kaiju, and Lyrical Luth use the current official ROS repository. Rolling Ridley uses the official testing repository.

Installation variants

Variant	Intended use	Package family
base	Headless systems, robots, and minimal installations	ROS base metapackage
desktop	Workstations that need GUI tools and common desktop packages	ROS 1 desktop-full or ROS 2 desktop

EOL support

EOL distributions use the signed final repositories at snapshots.ros.org. The installer downloads the ROS Snapshot Builder public key from Ubuntu's keyserver and accepts it only when its complete fingerprint matches:

4B63 CF8F DE49 746E 98FA 01DD AD19 BAB3 CBF1 25EA

The snapshot repository uses HTTP because its current TLS certificate does not match the hostname. Apt signature verification remains enabled; the installer never uses trusted=yes or unauthenticated package installation.

Your Ubuntu package sources must already work. For an EOL Ubuntu release, configure its archived sources and include the universe component before running the installer.

How installation works

1. Validate the distribution, variant, Ubuntu release, and universe component.
2. Configure the official current, testing, or final snapshot repository.
3. Confirm that the selected metapackage exists for the current architecture.
4. Install the metapackage and verify /opt/ros/<distribution>/setup.bash.
5. Print the shell command needed to use the installation.

License

This repository is licensed under the Apache License 2.0. ROS packages installed by this project remain subject to their respective licenses.

Distribution artwork by illustrator Joshua Ellingson is provided by Open Robotics and the ROS Wiki under CC BY-NC 4.0 and remains subject to the ROS trademark policy.