Robotnik ROS images

This repository contains the configurations for generating Robotnik ROS Docker images using Docker Compose and delivering them to our registries.

The configuration files are created with the yq template engine.

These images are used as base images for the Robotnik software, as well as for building and testing ROS packages.

The images are created for the different ROS distros (Melodic, Noetic, Humble, Iron, Jazzy, Rolling, etc)

Repository structure

folder	description
resources	Contains the basic images, used to build other images
examples	Contains example images, used to demonstrate the usage of the basic images
build.sh	Script to build the basic images for the different ROS distros
.github	Configuration of Github Actions and Workflows to automate the build and push of the images

Basic Images

In the resources folder we find three basic images:

• base: Image with ROS installed and some utilities from Robotnik
• builder: Based on base, includes tools to compile source code and generate deb packages
• gui: Based on base, includes tools to serve graphical applications via VNC

Automatic Image Generation

We have setup the automatic generation of the images for the following ROS distros:

ROS version	ROS distro	Image name
1	Melodic	melodic
1	Noetic	noetic
2	Humble	humble
2	Iron	iron
2	Jazzy	jazzy
2	Rolling	rolling

The images are tagged with the ROS version, type, version or commit hash, and date. For example, noetic-base-0.1.0-20200818 is the image with ROS1 Melodic, type base, version 0.1.0 and date 20200818. The image without version and date is the latest version of the image.

This configuration is stored in the .github folder.

Registries

The images are stored in the following registries:

Registry	Images
Harbor	robotnik/ros:<distro>-<type>
Docker Hub	robotnik/ros:<distro>-<type>

Examples

All the examples are in the examples folder.

ROS1

• Basic
• Sources as installed debian packages
• Generate deb files
• Rviz through web

ROS2

• Basic
• Developer workspace
• Sources as installed debian packages
• Generate deb files
• Multiple domains
• Nvidia container toolkit
• Rviz through vnc
• Rviz through web interface

How images can be created and uploaded to registries

License

Copyright (c) 2025, Robotnik Automation S.L. All rights reserved.

Licensed under the BSD 2-Clause License.