Install ROS on macOS - umrover/mrover-ros2 GitHub Wiki

Installation:

  1. Disable SIP: You must disable system protection

  2. Install xcode

[!IMPORTANT]
You must have installed xcode (the entire editor not just command line tools)

Make sure to open the installation

  1. Install brew

  2. Run echo "source ~/.ros2rc" >> ~/.zshrc

  3. Run curl -o ./bootstrap.sh -LO https://raw.githubusercontent.com/jbrhm/MACOS-HUMBLE/refs/heads/main/bootstrap.sh && chmod +x bootstrap.sh &&./bootstrap.sh

[!IMPORTANT]
If you run into the issue fatal error: 'Availability.h' file not found run sudo xcode-select -s /Applications/Xcode.app/Contents/Developer to switch from command line xcode to developer xcode

If you encounter an error with your qt version run brew uninstall --ignore-dependencies qt and open a new terminal and then type in the rest of the commands starting with colcon build ...

  1. Run ./build.sh

  2. Run ros2 launch mrover simulator.launch.py

Alternative VM Installation

If you're having trouble with the regular installation above(installation failing, simulator crashing, etc), ask a lead if you should use a VM instead. If so follow the installation method here.