setup_docker.md

Setup RAI with docker

Important

Docker images are experimental. For tested setup, see the local setup.

1. Build the docker image

Choose the docker image based on your preferred ROS 2 version.

1.1. Humble

docker build -t rai:humble --build-arg ROS_DISTRO=humble -f docker/Dockerfile .

1.2. Jazzy

docker build -t rai:jazzy --build-arg ROS_DISTRO=jazzy -f docker/Dockerfile .

2. Run the docker container

Tip

If you intend to run demos on the host machine, ensure the docker container can communicate with it. Test this by running the standard ROS 2 example with one node in docker and one on the host: link. If topics are not visible or cannot be subscribed to, try using rmw_cyclone_dds instead of the default rmw_fastrtps_cpp.

2.1. Humble

docker run --net=host --ipc=host --pid=host -it -v $(pwd):/rai rai:humble

2.2. Jazzy

docker run --net=host --ipc=host --pid=host -it -v $(pwd):/rai rai:jazzy

3. Run the tests to confirm the setup

cd /rai
source setup_shell.sh
poetry run pytest