OSRF Docker Images

This repo hosts Dockerfiles and scaffolding for images in the Official Library and OSRF Organization on Docker Hub.

Table of Contents

Official docker library
Official ROS (1 and 2) images
Official Gazebo images
OSRF ROS (1 and 2) overlay images
OSRF ROS 2 development images
OSRF Gazebo overlay images
OSRF ROS Legacy images

CI	Status
ROS
ROS 2
Gazebo

---

Official Library

The following repos are hosted under the Official Library on Docker Hub. These images are tagged for production and general downstream use. If you’re targeting released versions of respective projects, then these are recommended.

ROS

This repo contains images available for ROS, both ROS 1 and ROS 2. For more documentation on using these images, view the Docker Hub repo link above. Images are tagged by distribution name, meta package, as well as code name for supported OS base images. For complete listing of tag, view the Repo Info link below.

This repo also contain images for the ROS 2 Rolling Ridley distribution, this distribution is a rolling release providing the latest bleeding edge packages available via apt. Note that these will be updated regularly and may jump base image without notice. It sits nicely between the official ROS distributions and the nightly images.

Repo Info

Architectures

Type	Status
amd64
arm32v7
arm64v8

Gazebo

This repo contains images available for Gazebo. For more documentation on using these images, view the Docker Hub repo link above. Images are tagged by releases version, meta package, as well as code name for supported OS base images. For complete listing of tag, view the Repo Info link below.

Repo Info

Architectures

Type	Status
amd64

---

OSRF Profile

The following repos are hosted under the OSRF Organization on Docker Hub. These images are tagged for development and advanced use cases. If you require extra dependencies not available from the Official Library images above, then using these images may help save you build time during continuous integration or local development.

ROS

This repo builds ROS (both ROS 1 and ROS 2) images FROM the Official Library by including additional meta-packages such for desktop installations. These images may be helpful using containers for development or when display forwarding when using GUIs.
Images must be pulled using an explicit tag e.g:

docker pull osrf/ros:<tag_name>

List of tags available at https://hub.docker.com/r/osrf/ros/tags

Repo Info

Architectures

Type	Status
amd64

ROS2

This repo contains images specific to ROS 2, and are particularly for development and continuous integration. These may contain experimental features or unstable interfaces for testing the latest ROS 2 branches.
Images must be pulled using an explicit tag e.g:

docker pull osrf/ros2:<tag_name>

List of tags available at https://hub.docker.com/r/osrf/ros2/tags

Repo Info

• testing
  • Description:
    • closely mimics the Official Library images but sources testing apt repo
    • minimal size with no ros-rolling-* packages pre-installed
  • Purpose:
    • intended for Continuous Integration and testing package syncs
    • small image size and kept fresh by rebuilding upon package updates
• nightly
  • Description:
    • includes pre-installed environment from nightly job on the ci.ros2.org and pre-installed DDS implementations:
      • Fast-RTPS (default)
      • CycloneDDS
    • closely mimics the Official Library images as be interchangeable
  • Purpose:
    • intended for CI and testing against the latest nightly builds
    • early detection of regressions or deprecation from upstream
• nightly-rmw
  • Description:
    • builds FROM nightly and installs open source libraries
    • currently identical to nightly
  • Purpose:
    • intended for CI and testing against more rmw implementations
• nightly-rmw-nonfree
  • Description:
    • builds FROM nightly-rmw and installs closed source libraries
    • including non free vendors:
      • Connext
  • Notice:
    • includes third party license agreements for non free software
    • including the Open Community Source license from RTI
• devel
  • Description:
    • includes pre-installed dependencies for building from source
    • closely mimics the source install setup instructions
  • Purpose:
    • intended for development and bootstrapping source builds
    • small image size and kept fresh by rebuilding every day
• source
  • Description:
    • builds FROM devel and compiles ros2 from source
    • closely mimics the Official Library images as be interchangeable
  • Purpose:
    • intended for development and bootstrapping source builds
    • when an isolated workspace is needed for dependency checking
  • Notice:
    • no pre-built image hosted on Docker Hub
    • provides many ARG options, like running tests
• Note: only core packages are available via these images. An alternative for development is to use the rolling distribution images, while less recent than the nightly they allow you to install many ROS packages from deb.

Architectures

Type	Status
amd64

Gazebo

This repo builds FROM the Official Library by including additional meta-packages such for desktop installations. These images may be helpful using containers for development or when display forwarding when using GUIs.
Images must be pulled using an explicit tag e.g:

docker pull osrf/gazebo:<tag_name>

List of tags available at https://hub.docker.com/r/osrf/gazebo/tags

Repo Info

Architectures

Type	Status
amd64

ROS Legacy

This repo contains legacy images for ROS 1, specifically for releases predating the Official Library. This is intended as a complementary repo only for older releases of ROS that were not archived in the Official Library. Images must be pulled using an explicit tag e.g:

docker pull osrf/ros_legacy:<tag_name>

List of tags available at https://hub.docker.com/r/osrf/ros_legacy/tags

Repo Info

Architectures

Type	Status
amd64