Update to vscode_ros2_workspace

ROS ROS General
, , ,
1

I’ve updated athackst/vscode_ros2_workspace so you can use the main branch as a single template across ROS distributions.

What changed

  • The default branch now supports any ROS version—just set the desired base image in .devcontainer/Dockerfile’s FROM line. The template currently defaults to osrf/ros:jazzy-desktop-full.

  • The repo includes guidance for GUI enablement (X11/Wayland, NVIDIA/WSL2 notes) and non-root user development (UID/GID hints). After building the devcontainer, you’ll see the ros user and can adjust UID/GID if needed.

Quick start

  1. Click “Use this template” on the repo and create your workspace. The README notes that the default branch works for any ROS by changing the FROM line in .devcontainer/Dockerfile.

  2. (Optional) Switch ROS versions by setting, e.g.:

    # .devcontainer/Dockerfile
FROM osrf/ros:humble-desktop-full

  3. Open in VS Code – it will build the dev container for you; your terminal user will be ros. If you hit X11/Wayland auth or display issues, the README documents fixes (DISPLAY, WAYLAND variables, volumes, NVIDIA/WSL2 notes).

Extras included

  • Preconfigured linters/formatters, tasks, and launch configs.

  • CI workflow you can tailor to your project.

Why this helps

  • One template for all supported ROS 2 distros; simpler upgrades and onboarding.

  • Built-in GUI and non-root guidance improves day-to-day dev experience out of the box.

Feedback welcome
If you try this out—especially on different distros or GPU/WSL2 setups—please share what works and what doesn’t.

14 Likes