You're reading the documentation for an older, but still supported, version of ROS 2. For information on the latest version, please have a look at Foxy.

Releasing a ROS 2 package with bloom


This page describes how to prepare a repository for release on the public ROS 2 buildfarm. After you’ve created a package, this is the next step towards getting your package in to the publicly-available Debian packages (i.e., you will be able to install the package via apt). This page includes the ROS 2-specific instructions to execute before following the Bloom release tutorial on the ROS Wiki.

Required Tools

  • bloom >= 0.9.7

  • catkin_pkg >= 0.4.10

Ensure that you have the latest version of bloom and catkin_pkg

See above version requirements.

  • Make sure you have the ros repositories in your sources (see instructions here).

  • Install the latest version of bloom and catkin_pkg:

    sudo apt install python3-catkin-pkg python3-bloom

If you’re using a version of bloom older than 0.6.8 you’ll need to use the v3 index url for releasing.


No differences from ROS 1 Bloom

If you’ve bloomed packages before in ROS 1, the ROS 2 process is exactly the same.


Same as in ROS 1: Following this tutorial

If porting a ROS 1 package to ROS 2, it’s recommended to create a new -release repository.

Build Status