Prerequisites

This page lists what you need on your host machine to build and run ADI Robotics SDK Docker images.

Why Docker?

Each ROS2 distribution is tied to a specific Ubuntu release (e.g. Humble requires Ubuntu 22.04). Docker removes this constraint — you can build and run the ADI Robotics SDK on any host that supports Docker, regardless of the host OS version.

Docker also packages all ADI-specific dependencies into reproducible images, so you do not need a native ROS2 installation. Everything runs inside containers.

System Requirements

Resource	Requirement
Operating System	Any Linux distribution, Windows 10/11 with WSL2, or macOS
Docker	Docker Engine 24+ with Compose v2 plugin
Git	Git 2.x (for cloning the repository and submodules)

Docker Engine

Follow the official installation guide for your platform:

• Install Docker Engine on Ubuntu

• Install Docker Desktop for Windows (WSL2 backend)

• Install Docker Desktop for Mac

After installation on Linux, add your user to the docker group so you can run Docker commands without sudo:

sudo usermod -aG docker $USER

Log out and back in (or run newgrp docker) for the group change to take effect.

Verify Docker is working:

docker run hello-world

You should see Hello from Docker! in the output.

Docker Compose (v2)

Docker Compose v2 ships as a plugin with recent Docker Engine and Docker Desktop installations. Verify it is available:

docker compose version

Warning

If the command is not found, your Docker installation may be outdated or incomplete.

See the Docker Compose install docs for more information.

Git

sudo apt install git

See the Git installation guide for other platforms.

Verification Checklist:

Run each command and confirm the expected output:

docker --version           # Docker version 24.x or newer
docker compose version     # Docker Compose version v2.x
docker run hello-world     # prints "Hello from Docker!"
git --version              # git version 2.x

If all four checks pass, you are ready to proceed.