Install Gazebo using Ubuntu packages

This tutorial covers the installation of Gazebo packages using the packages.osrfoundation.org repository, designed for those who want to follow the faster development path but still a stable one.

Some notes:

  • Gazebo11 is also released as an Ubuntu official package: check which version is available for every distribution. The version in Ubuntu repositories rarely change for stability reasons.

  • Starting with Ubuntu Jammy (22.04) Open Robotics won't be releasing more binary packages of Gazebo11 in packages.osrfoundation.org for the new Ubuntu versions. The migration to new Gz, formerly Ignition is recommended. Binaries coming directly from Ubuntu repositories can be used for these new platforms. The upstream code will keep accepting patches for new software versions so from-source installations will also be an option.

  • If you are a ROS user, please read the tutorial about the ROS/Gazebo installation.

Default installation: one-liner

  1. Install

    curl -sSL http://get.gazebosim.org | sh
  2. Run


Alternative installation: step-by-step

  1. Setup your computer to accept software from packages.osrfoundation.org.

    sudo sh -c 'echo "deb http://packages.osrfoundation.org/gazebo/ubuntu-stable `lsb_release -cs` main" > /etc/apt/sources.list.d/gazebo-stable.list'

    You can check to see if the file was written correctly. For example, in Ubuntu Bionic (18.04), you can type:

    cat /etc/apt/sources.list.d/gazebo-stable.list

    And if everything is correct, you should see:

    deb http://packages.osrfoundation.org/gazebo/ubuntu-stable bionic main
  2. Setup keys

    wget https://packages.osrfoundation.org/gazebo.key -O - | sudo apt-key add -
  3. Install Gazebo.

    First update the debian database:

    sudo apt-get update

    Hint: make sure the apt-get update process ends without any errors, the console output ends in Done similar to below:

    $ sudo apt-get update
    Hit http://ppa.launchpad.net bionic/main Translation-en
    Ign http://us.archive.ubuntu.com bionic/main Translation-en_US
    Ign http://us.archive.ubuntu.com bionic/multiverse Translation-en_US
    Ign http://us.archive.ubuntu.com bionic/restricted Translation-en_US
    Ign http://us.archive.ubuntu.com bionic/universe Translation-en_US
    Reading package lists... Done

    Next install gazebo-11 by:

    sudo apt-get install gazebo11
    # For developers that work on top of Gazebo, one extra package
    sudo apt-get install libgazebo11-dev
  4. Check your installation