TODO: add wsl install link

Step 1: link

Install vscode and download Remote Development plugin:

Step 2: link

Create a folder called ros2_ws somewhere on your computer and open that folder in vscode by going to File → open folder

ctrl+shift+p and type: Install Docker

The Docker install will take sometime and at the end it will ask you to restart

Once you restart open Docker and finish the installation

It will ask you to make an account but you can just press skip on the top right

Then reopen vscode and open the ros2_ws folder you just made

press ctrl+shift+p and type: reopen in container

Choose “Add configuration to workspace”

vscode will now install ROS2 onto your computer so this may take some time.

Step 3: link

Once ROS2 has installed inside your dev-container I recommend you install these two plugins:

Step 4: add to .bashrc link

In the Docker file inside the .devcontainer folder add this line at the very bottom:

  RUN echo "source /usr/share/colcon_argcomplete/hook/colcon-argcomplete.bash" >> ~/.bashrc
RUN echo "source /usr/share/colcon_cd/function/colcon_cd.sh" >> ~/.bashrc
RUN echo "export _colcon_cd_root=/opt/ros/humble/" >> ~/.bashrc
RUN sudo apt install -y python3-pip 
  

To test if everything installed correctly open a terminal with ctrl+`` or pressing ctrl+shift+pand typingtoggle terminal`:

then

Then type lsb_release -a and echo $ROS_DISTRO in the command prompt and you should get similar responses:

Install: to get displays to pass over

   sudo apt install xcb
  

After installing xcb in the container outside of the container run:

  xhost +local:
  

Note: you may have to rebuild the container:

Press `ctrl+shift+P` and type **rebuild**

![image.png](https://prod-files-secure.s3.us-west-2.amazonaws.com/d518164a-d88e-44d1-a4ee-3adb3bd8bce0/6c2be660-2618-4c38-9c26-53554f7a0b7b/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=ASIAZI2LB466WYJHM362%2F20251128%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20251128T012835Z&X-Amz-Expires=3600&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEN7%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLXdlc3QtMiJHMEUCIFO9iX%2BVjnTRe4BdFTEIRhmoyNF%2FmVG0QpoP6z70raQGAiEAuNZ68O5hLmMc%2BFTagT1K4qQS1a%2F%2F3%2BQL22yoE2zlVIgqiAQIp%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARAAGgw2Mzc0MjMxODM4MDUiDCaAmQdUziL0YMo%2BayrcA1YslGdNm3EW3kFKh8HA%2BLNzWR07d4%2F%2FEC4UkAC28LCJzpVXccV%2FPLxGnniIs5EePmP5NtkxdVx%2FZLsUD9AKHI3u7y8P2jUVHQ44tp%2BdDDsa%2BsRq8HHK%2BcvSzUCGYHh8S8KhYccioMreQUcUbADMaB8s4984k4ndDSb5TYOW3Zki4OorrHpnjc8TrCJpgLy%2Fa46Z2Xe9AnH42EJa2ldQtZ4wr8%2FT%2B1piSuTXK6jgJHSgt94B%2Bk0MNLddrTxrLGVQH3n0Ex3ZAlc8jt3B1x%2FkYTXjpZ%2FfKFdp1h4Mg8I3qn%2B1QueJ8qKX16OAq9jJzcjQqZrXXnzKqDGkbDOa8FfSdhR3juBNiVdxzPpqSltQSbhnsRjr3fAFAGetZUJfQ8A89UtH3jb2otl37Tt8LUXmrirEefDgCTEpxXwhUhf83I02AGkGqKKDpkPUjaA1xymsK3fzWCJsxQq9XQ0WKSEWnY2mRrCoG3H%2B7Q6GeC0x0qwOb8OFWpbvvguAfs6rhtrwvJMz95JOu6qDZhZEG%2FbtFrS9ZPCdpImsLRjgb%2BklOvm2s%2F44vODil5cyluvbtlnsIiG15UdB3scWYRCihPPxVuVZBFJqMLyWPx6dxG2iJoPOgpe%2FAs%2Fn1qVO%2Fu4nMNOFo8kGOqUBqbfovTAXZ%2BaBdmZYPxRvd0sSIpvSfSiO3W7Zo56FFvy27CmtffwHVPww2JFpFYCk3%2FdA6Pw6kKHXJUVzI4%2FiY7E9Dq%2BVIkaeogxUE5WVn%2By%2FnKUYmre8ejB7SpTa6ZAhLnFs%2F7wd4Vr9XbN%2FKHK68EjI%2BZxKsJZHfj%2Bhm08zu5dCITMY9p5saOlBnBdsvj5hxROcLrbTiV%2BfACU5FxTG6hkNAbJs&X-Amz-Signature=d92fecf09adbc8fdee11f1967171e28e0a744cc30e3242e18cda6d26ca1edb5b&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

video guide if you get stuck: https://www.youtube.com/watch?v=dihfA7Ol6Mw&t=650s

to test if windows forward run in the container:

  rviz2
  

Now you should be setup and should move onto the next guide