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
- Description:
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
- includes pre-installed environment from nightly job on the ci.ros2.org and pre-installed DDS implementations:
- Purpose:
- intended for CI and testing against the latest nightly builds
- early detection of regressions or deprecation from upstream
- Description:
nightly-rmw
- Description:
- builds
FROM
nightly
and installs open source libraries - currently identical to
nightly
- builds
- Purpose:
- intended for CI and testing against more rmw implementations
- Description:
nightly-rmw-nonfree
- Description:
- builds
FROM
nightly-rmw
and installs closed source libraries - including non free vendors:
- Connext
- builds
- Notice:
- includes third party license agreements for non free software
- including the
Open Community Source
license from RTI
- Description:
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
- Description:
source
- Description:
- builds
FROM
devel
and compiles ros2 from source - closely mimics the Official Library images as be interchangeable
- builds
- 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
- Description:
- 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 |