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