Binary Installation on Ubuntu

Harmonic binaries are provided for Ubuntu Jammy (22.04) and Ubuntu Noble (24.04). The Harmonic binaries are hosted in the packages.osrfoundation.org repository. To install all of them, the metapackage gz-harmonic can be installed.

WARNING: for gazebo-classic (eg. `gazebo11`) users: `gz-harmonic` cannot be installed alongside with `gazebo11` by default. To facilitate the migration this can be done using the instruction detailed in Installing Gazebo11 side by side with new Gazebo

First install some necessary tools:

sudo apt-get update
sudo apt-get install lsb-release gnupg

Then install Gazebo Harmonic:

sudo curl https://packages.osrfoundation.org/gazebo.gpg --output /usr/share/keyrings/pkgs-osrf-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/pkgs-osrf-archive-keyring.gpg] http://packages.osrfoundation.org/gazebo/ubuntu-stable $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/gazebo-stable.list > /dev/null
sudo apt-get update
sudo apt-get install gz-harmonic

All libraries should be ready to use and the gz sim app ready to be executed.

Head back to the Getting started page to start using Gazebo!

Uninstalling binary install

If you need to uninstall Gazebo or switch to a source-based install once you have already installed the library from binaries, run the following command:

sudo apt remove gz-harmonic && sudo apt autoremove

Troubleshooting

See Troubleshooting