Ionic binaries are provided for Ubuntu Jammy (22.04) and Ubuntu 24.04 (when it's released). The
Ionic binaries are hosted in the packages.osrfoundation.org repository.
To install all of them, the metapackage gz-ionic can be installed.
WARNING: gz-ionic cannot be installed alongside gazebo-classic (eg. gazebo11) since both use the gz command line tool. Trying to install gz-ionic on a system that already has gazebo-classic installed from binaries will cause gazebo-classic and its dependencies to be uninstalled. Currently, the workarounds for this are to install from source or to use Docker gazebo-classic so they are not installed side-by-side on the same system.
First install some necessary tools:
sudo apt-get update
sudo apt-get install lsb-release wget gnupgThen install Gazebo Ionic:
sudo wget https://packages.osrfoundation.org/gazebo.gpg -O /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-ionicAll 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!
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-ionic && sudo apt autoremoveSee Troubleshooting