Skip to main content

​
Supported Platform

RequirementSupported
Operating SystemUbuntu 20.04+ (Debian-based distributions)
Architecturex86_64 (amd64)
ROS VersionROS2 Humble (LTS) or Jazzy recommended; Foxy is EOL and unsupported
SimulatorGazebo Sim (Harmonic)
ROS2 Foxy reached end-of-life in June 2023. It may work with Drift but is not tested or supported. Use Humble or Jazzy for a supported experience. Support for additional ROS and Gazebo versions is on the roadmap.

​
Dependencies

Drift CLI requires the following to be installed on your system:

​
ROS2

Drift works with ROS2 distributions. Recommended: ROS2 Humble (LTS). Install ROS2 Humble on Ubuntu: official install guide or ask Drift to install it after launching.

​
Gazebo Sim

Drift uses Gazebo Sim (Harmonic) for simulation rendering and physics. Install Gazebo Harmonic: official install guide or ask Drift to install it after launching.

​
Additional Tools

Drift works in any terminal, including the integrated terminal in VS Code or Cursor with no extra setup.
Drift relies on standard ROS2 build tools that come with a typical ROS2 installation:
  • colcon Build tool for ROS2 workspaces
  • rosdep Dependency management for ROS2 packages

​
Verifying Your Setup

After installing ROS2 and Gazebo, verify everything is working: 
# Check ROS2
ros2 --version

# Check Gazebo
gz sim --version

# Check Drift
drift --help
If all three commands return version information, you’re ready to go.