A ROS 2 installer for Ubuntu

ROS 2.
Get started.

Install ROS 2 with a single command. The script detects your Ubuntu version and CPU architecture, then installs the matching ROS 2 LTS distribution using official APT packages.

POSIX shUbuntu LTSOpen source · MIT

Install in your terminal

curl -fsSL https://get-ros2.com/install.sh | sh

Want to inspect it first? Read install.sh

Requires internet access, a working APT configuration, and root or sudo privileges.Verify the download before installing ↓

Supported environments

01 / Compatibility

Supported environments and automatically selected ROS 2 distributions.
Ubuntu	ROS 2	Architecture
22.04 LTS	Humble	amd64 / arm64
24.04 LTS	Jazzy	amd64 / arm64
26.04 LTS	Lyrical	amd64 / arm64

The default installation includes RViz and demos. For servers and containers, use --variant ros-base. Preview the planned changes with --dry-run. See the README for all available options.

Using Windows? Run the script inside a supported Ubuntu installation on WSL 2. This script does not support native Windows, macOS, other Linux distributions, or 32-bit environments. See the official ROS 2 installation instructions for other platforms.

Inspect. Verify. Install.

02 / SHA-256

Run the commands below on a supported Ubuntu system to download the installer and its checksum file into a temporary directory. The installer runs only if both downloads and the checksum check succeed.

Verify and install

(
  download_dir=$(mktemp -d) &&
  cd "$download_dir" &&
  curl -fsSL --proto '=https' --proto-redir '=https' \
    https://get-ros2.com/install.sh -o install.sh &&
  curl -fsSL --proto '=https' --proto-redir '=https' \
    https://get-ros2.com/install.sh.sha256 -o install.sh.sha256 &&
  sha256sum --check --strict install.sh.sha256 &&
  sh ./install.sh
)

View the SHA-256 checksum

A successful check prints install.sh: OK. If verification fails, stop and download the installer and checksum file from the same release. Do not bypass the check.

The version available on this website may differ from the latest GitHub release. To install a specific version, download both files from that release's Assets section and follow the “Verify a specific release” instructions in the README.

A checksum is not a digital signature. It verifies that the file matches the published hash, but does not independently verify the publisher's identity. Someone who can replace both files could provide a matching checksum for an altered installer.

Releases, docs, and support

03 / Resources

Latest release ↗

Download the installer and checksum file from the latest release's Assets section.

See README →

Find installer options, instructions for setting up your shell, and troubleshooting guidance for the version on this website.

Report an issue ↗

Found a problem? Share your Ubuntu version, architecture, and relevant error output.

Building ROS 2 from source? Use setup-source.sh to prepare the development tools and rosdep. See the README for supported environments, SHA-256 verification, and the remaining build steps. The UNOFFICIAL / WITHOUT WARRANTY notices also apply to source setup.