# 🎉 Gazebo Ionic Test and Tutorial Party Instructions

**URL:** <https://discourse.openrobotics.org/t/gazebo-ionic-test-and-tutorial-party-instructions/48883>\
**Category:** Gazebo General\
**Tags:** gazebo\
**Created:** [August 29, 2024, 6:28pm UTC](https://discourse.openrobotics.org/t/gazebo-ionic-test-and-tutorial-party-instructions/48883 "2024-08-29T18:28:50Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![azeey](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.openrobotics.org/azeey/32/6795_2.png) [@azeey](https://discourse.openrobotics.org/u/azeey)\
**Post date:** [August 29, 2024, 6:28pm UTC](https://discourse.openrobotics.org/t/gazebo-ionic-test-and-tutorial-party-instructions/48883/1 "2024-08-29T18:28:50Z")

</div>

![ionic_tutorial_party](https://us1.discourse-cdn.com/flex022/uploads/ros/original/3X/f/8/f8af73bfc587cc2bedfbf5341863abbf0734589d.jpeg)

Hi Gazebo community,

As [mentioned previously](https://community.gazebosim.org/t/save-the-date-gazebo-ionic-tutorial-party/2949) we’ll be conducting a testing and tutorial party for the next Gazebo release, Ionic. If you missed the kickoff meeting for the tutorial party, here’s the video:

[![](https://us1.discourse-cdn.com/flex022/uploads/ros/original/3X/4/2/42dc2eff2d9d6349315d070f86f22ac0dec1a897.jpeg "Gazebo Ionic Test and Tutorial Party Kickoff August 29th, 2024") ](https://vimeo.com/1004147498)

We’ll be partying from August 29th until Friday, September 13th, 2025. As a reminder, to sweeten the pot, we will once again be sending out Ionic t-shirts 👕 to the top ten tutorial party animals (those who finish reviewing the most tutorials as measured by closed tickets). Since the t-shirts will be distributed as gift codes to the Gazebo T-Spring store 👉[**you must fill out this form after you close your first ticket**](https://forms.gle/4JsnKR4Up1DiHybk7).👈 _Participants must register no later than September 13, 2024 to be eligible for the swag give away_. **Additionally, every single one of the tutorial participants will be included in the Ionic release notes.** Unfortunately, we’re still working on the Gazebo Ionic artwork, so our Gazebo store isn’t quite ready yet, but we should have that up before the end of the Tutorial Party.

## Important Dates 📅

- 2024-08-29 → 2023-09-13 Ionic Tutorial Party
- 2024-09-16 → 2023-09-20 Internal Q&A
- 2024-09-25 Community Meeting Demo
- 2024-09-30 Official Release Announcement
- 2024-10-07 Tutorial Party top contributors announced  
(potentially earlier)
- 2024-09-30 Official Release Announcement
- TBD Graphic Release and T-Shirt Sale – (T-shirt / art will be delayed)

### How to Party! 🥳

The party process is fairly simple, and if all goes according to plan you should be able to validate a few tutorials in an hour or two and check out some recent upgrades to Gazebo. We’ll be using the issues in [this Github repository](https://github.com/gazebosim/gazebo_test_cases) to track our progress as we’ve created an automated system for generating all of the different tutorials we need to review. Here are the steps (to party):

- Pick a tutorial flavor by filtering out the Github issues using the corresponding labels. The [Readme](https://github.com/gazebosim/gazebo_test_cases#readme) will be a good starting point and has some helpful tips on how to filter Github issues. Note that the Ionic release supports two installation methods (source and binaries) and a few host operating systems ([Ubuntu Noble, Windows, MacOS Monterey, and Ventura](https://github.com/gazebo-tooling/release-tools/issues/1158)).
- Install the pre-releases on your computer (we’ve include directions for each host operating system below, but they [are all listed here](https://gazebosim.org/docs/ionic/install/#))
- Make sure to check out the [troubleshooting](https://gazebosim.org/docs/ionic/troubleshooting/) page if you run into any issues.
- Find an open issue from the [Gazebo testing repository](https://github.com/gazebosim/gazebo_test_cases) and comment on the issue stating that you would like to test the tutorial contained in the issue.
- Run through the tutorial from start to finish! Be really thorough; if you think you could improve the tutorial feel free to add to it. At this point one of three things will happen:
  - The tutorial works perfectly!
    - Close the issue with a comment that everything works as expected.

  - The tutorial has issues…
    - But, you can fix them and send us a PR.
    - Open the PR and drop a link on the issue.

  - You can’t fix them (that’s ok!)
    - Post a comment describing the problems you faced.
      - Open the PR and drop a link on the issue.

    - You can’t fix them (that’s ok!)
      - Post a comment describing the problems you faced.

- :ros: If you’re doing a tutorial that works with ROS, make sure to follow the [ROS integration testing](https://github.com/gazebosim/gazebo_test_cases?tab=readme-ov-file#ros-integration-tests) instructions.
- 📦 If you don’t have Ubuntu Noble installed natively, we’ve provided Dockerfiles and [instructions](https://github.com/gazebosim/gazebo_test_cases?tab=readme-ov-file#dont-have-a-compatible-platform) to do the tests using Docker.
- 👉[Fill out the registration form after you close your first ticket](https://forms.gle/4JsnKR4Up1DiHybk7).👈
- Try another tutorial!

## Need Help? ✋

If you find yourself in a pickle don’t worry, we’ve got you covered! Our recommendation is that you first comment in the ticket you are working on and ping a member of the core team. Alternatively you can bring your questions to the #gazebo-help channel on our [Discord server](https://discord.com/servers/open-robotics-1077825543698927656). If you have general T&T party questions feel free to ask them below. Otherwise, here are some helpful resources if you get stuck:

- [Gazebo Discord Server (use #gazebo-help channel)](https://discord.com/servers/open-robotics-1077825543698927656)
- [Full list of Gazebo resources](https://github.com/gazebosim)
- [Gazebo Documentation](https://gazebosim.org/docs/)
- [Gazebo on Stack Exchange](https://robotics.stackexchange.com/)
- [Gazebo Sim Community](https://community.gazebosim.org/)

## Installing Pre-releases

All Ionic libraries have pre-releases. The following installation methods are available:

- [Install binaries on Ubuntu Noble](https://gazebosim.org/docs/ionic/install_ubuntu/)
- [Build from source on Ubuntu Noble](https://gazebosim.org/docs/ionic/install_ubuntu_src/)
- [Install binaries on MacOS Monterey / Ventura](https://gazebosim.org/docs/ionic/install_osx/)
- [Build from source on MacOS Monterey / Ventura](https://gazebosim.org/docs/ionic/install_osx_src/)
- [Build from source on Windows 10/11](https://gazebosim.org/docs/harmonic/install_windows_src) (EXPERIMENTAL)

---

<div class="post-metadata">

**Author:** ![gbiggs](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.openrobotics.org/gbiggs/32/30361_2.png) [@gbiggs](https://discourse.openrobotics.org/u/gbiggs)\
**Post date:** [September 1, 2024, 12:39pm UTC](https://discourse.openrobotics.org/t/gazebo-ionic-test-and-tutorial-party-instructions/48883/2 "2024-09-01T12:39:58Z")

</div>

Pinned globally on September 1, 2024, 12:39pm UTC



---

<div class="post-metadata">

**Author:** ![gbiggs](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.openrobotics.org/gbiggs/32/30361_2.png) [@gbiggs](https://discourse.openrobotics.org/u/gbiggs)\
**Post date:** [September 1, 2024, 12:40pm UTC](https://discourse.openrobotics.org/t/gazebo-ionic-test-and-tutorial-party-instructions/48883/3 "2024-09-01T12:40:10Z")

</div>

Made this a banner on September 1, 2024, 12:40pm UTC. It will appear at the top of every page until it is dismissed by the user.



---

<div class="post-metadata">

**Author:** ![azeey](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.openrobotics.org/azeey/32/6795_2.png) [@azeey](https://discourse.openrobotics.org/u/azeey)\
**Post date:** [September 9, 2024, 10:29pm UTC](https://discourse.openrobotics.org/t/gazebo-ionic-test-and-tutorial-party-instructions/48883/4 "2024-09-09T22:29:27Z")

</div>

We’ve been making great progress on the Tutorial party. Thanks everyone for the participation!!

Most of the issues we’ve closed so far have been for the Ubuntu Noble platform, so there are still plenty of macOS and Windows issues left. **If you have a setup with either macOS or Windows, we would love for you to participate. Please come join the party** :gazebo: 🎉

---

<div class="post-metadata">

**Author:** ![Katherine\_Scott](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.openrobotics.org/katherine_scott/32/4434_2.png) [@Katherine\_Scott](https://discourse.openrobotics.org/u/Katherine_Scott)\
**Post date:** [September 10, 2024, 11:22pm UTC](https://discourse.openrobotics.org/t/gazebo-ionic-test-and-tutorial-party-instructions/48883/5 "2024-09-10T23:22:53Z")

</div>

Hi Everyone,

I am sitting in a room with @azeey, @clalancette, and a few others right now. We’re looking at the Test and Tutorial Party results and we need some help.

Here’s the good news:

🎉 We are basically done with Ubuntu tickets for Ionic.

☹ Here is the bad news :

- [We still have 177 open tickets for Windows](https://bit.ly/IonicWindows)
- [We still have 149 open tickets for MacOS](https://bit.ly/IonicMac)

We desperately need the community’s help testing on these platforms. If you happen to have a Windows VM, or a Mac sitting around we would really appreciate your help.

We’re all in a room right now firing up VMs to push through some testing and we love some help!

---

<div class="post-metadata">

**Author:** ![azeey](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.openrobotics.org/azeey/32/6795_2.png) [@azeey](https://discourse.openrobotics.org/u/azeey)\
**Post date:** [September 12, 2024, 10:16pm UTC](https://discourse.openrobotics.org/t/gazebo-ionic-test-and-tutorial-party-instructions/48883/6 "2024-09-12T22:16:24Z")

</div>

If you participated in the tutorial party and want to be eligible for the T-shirt giveaway, please make sure you fill out this [form](https://forms.gle/4JsnKR4Up1DiHybk7) by 2024-09-12T12:00:00Z.

---

<div class="post-metadata">

**Author:** ![Katherine\_Scott](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.openrobotics.org/katherine_scott/32/4434_2.png) [@Katherine\_Scott](https://discourse.openrobotics.org/u/Katherine_Scott)\
**Post date:** [September 30, 2024, 6:25pm UTC](https://discourse.openrobotics.org/t/gazebo-ionic-test-and-tutorial-party-instructions/48883/7 "2024-09-30T18:25:25Z")

</div>

Removed this banner on September 30, 2024, 6:25pm UTC. It will no longer appear at the top of every page.