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.

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

• 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

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