h3ct0rdcc/ros2_dev repository overview

⁠ROS 2 development images

Ready-to-use ROS 2 environments for Humble, Jazzy and Lyrical, on amd64 and arm64:

• a desktop in your browser;
• VS Code devcontainers and code-server;
• SSH and Zenoh;
• support for rootless Docker.

Source, setup script and documentation: github.com/h3ct0r/ros2_devcontainer_docker_compose⁠

⁠Quick start

The repo's dev.sh detects your host (macOS, Linux, NVIDIA, rootless Docker) and starts the right container:

git clone https://github.com/h3ct0r/ros2_devcontainer_docker_compose.git
cd ros2_devcontainer_docker_compose
./dev.sh up

Then open http://localhost:3080/?autoconnect=true⁠ for the desktop, or http://localhost:3081⁠ for code-server.

To run an image directly:

docker run -d --name ros2 -p 3080:3080 -p 3081:3081 -p 3022:3022 --shm-size 1g h3ct0rdcc/ros2_dev:jazzy-desktop

⁠Tags

<distro>-<target>, for example jazzy-desktop. Every tag is multi-arch (amd64 + arm64).

The same images are on ghcr.io/h3ct0r/ros2_dev.

⁠Services

The desktop and code-server have no password unless VNC_PASSWORD and CODE_SERVER_PASSWORD are set.

⁠Documentation

• Getting started⁠
• Configuration⁠
• Networking and Zenoh⁠
• Running on a robot⁠
• Hosts and hardware⁠
• Images⁠

License: MIT.