Skip to main content

​
System Requirements

Before installing, make sure your system meets the requirements. See the full System Requirements page for details, supported platforms, and dependency installation instructions. In brief: Ubuntu 22.04 or 24.04, x86_64, and at least one simulator path — ROS2 Humble (on 22.04) or Jazzy (on 24.04) + Gazebo Sim (Harmonic), or MuJoCo 3.8.1+ via pip install mujoco. The fastest way to install Drift CLI:
Once installed, restart your terminal (or use the integrated terminal in VS Code or Cursor) and run:
You should see:

​
Manual Installation

If you prefer to install manually or the quick install doesn’t work for your setup:
  1. Download the latest .deb package from the GitHub Releases page
  2. Install with dpkg:
  1. To start, run:

​
Updating

Drift CLI detects new versions automatically. When an update is available, you’ll see a notification on startup:
To update, simply run inside the Drift prompt:
Or manually download and install the latest .deb from Releases.

​
Troubleshooting

​
”Command not found: drift”

Your shell hasn’t picked up the new binary yet. Restart your terminal or run:

​
Update fails

Manually download the latest .deb package from the releases page and install it with dpkg.

​
Permission denied errors

The installer may need sudo access. Make sure you have the proper permissions on your system.

​
Uninstalling

To remove Drift CLI:

​
Next Steps

Quickstart

Install complete? Jump into the quickstart to build your first simulation.

Commands Reference

Learn what drift init and drift simulate do and when to use them.