<aside> ⚠️
At time of writing (24/07/2025), these dev containers/VMs may be outdated. They may work with some modification, but it is easier to dual-boot or run Ubuntu 20.04 on a dedicated machine rather than running it in these containers/VMs currently.
</aside>
<aside> ⚠️
Make sure to install the correct version of ROS (Galactic or Foxy) for your chosen ROS Project. See ROS Projects to choose a project.
</aside>
<aside> ⚠️
Our GitHub contains our ROS projects in docker containers for Windows users. Mac users must setup a VM to use these repositories.
</aside>
ROS Workspace (Mac: Apple Silicon, Intel)
| Windows | Mac (Apple Silicon) | Mac (Intel) | |
|---|---|---|---|
| Install ROS Galactic | Clone an empty project from our GitHub and run in a dev container. | Setup ROS Galactic VM from pre-made UTM image. | Setup ROS Galactic VM from step-by-step made UTM image. |
| Install ROS Foxy | Clone an empty project from our GitHub and run in a dev container. | Setup ROS Foxy VM from pre-made UTM image. | Setup ROS Foxy VM from step-by-step made UTM image. |
| Setup EUFS Sim | Clone eufs_sim-docker from our GitHub and run in a dev container. Then follow readme instructions. | Setup ROS Galactic VM from pre-made UTM image. Then follow guide in readme (on GitHub). | Setup ROS Galactic VM from step-by-step made UTM. Then follow this guide. |
| Setup articu-project | Clone articu-project from our GitHub and run in a dev container. Then follow readme instructions. | Setup ROS Foxy VM from pre-made UTM image. Then follow guide in readme (on GitHub). | Setup ROS Galactic VM from step-by-step made UTM. Then clone artic-project from our GitHub and follow readme. |
*if you have a problem with any of these methods, please let us know by contacting the committee!