/docker_images

A repository to hold definitions of docker images maintained by OSRF

Primary LanguageDockerfile

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 Build Status
ROS 2 Build Status
Gazebo Build Status

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.

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.

Compare Images

Architectures

Type Status
amd64 Build Status
arm32v7 Build Status
arm64v8 Build Status

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.

Compare Images

Architectures

Type Status
amd64 Build Status

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.

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

Compare Images

Architectures

Type Status
amd64 Docker Build Status

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

Compare Images

  • 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

Architectures

Type Status
amd64 Docker Build Status

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

Compare Images

Architectures

Type Status
amd64 Docker Build Status

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

Compare Images

Architectures

Type Status
amd64 Docker Build Status