Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/drift-tech/drift-releases/llms.txt

Use this file to discover all available pages before exploring further.

Quick install

Get started with Drift CLI in seconds using the installation script:
curl -fsSL https://godrift.ai/install | bash
That’s it! Once installed, simply run drift to start.

System requirements

Before installing Drift CLI, ensure your system meets these requirements:
  • Operating system: Ubuntu 20.04+ (Debian-based distributions)
  • ROS: ROS2 (Humble, Foxy, or later recommended)
  • Gazebo: Gazebo Sim (Harmonic)
  • Architecture: x86_64 (amd64)
Support for older versions of ROS and Gazebo is in development.

Manual installation

If you prefer to install manually using the .deb package:
1

Download the package

Download the latest .deb package from the releases page.Current version: 1.0.12Direct download: drift-cli_1.0.12_amd64.deb
2

Install with dpkg

Install the package using dpkg:
sudo dpkg -i drift-cli_*.*.*_amd64.deb
3

Run Drift

Start Drift CLI:
drift

Verification steps

After installation, verify that Drift CLI is working correctly:
# Check if drift is installed
which drift

# View help information
drift --help

# Launch Drift CLI
drift
Once inside Drift, you can check your version:
drift> /version
You should see output showing version 1.0.12 or later.

Common installation issues

Command not found: drift

If you see “Command not found: drift” after installation, try restarting your terminal or running:
source ~/.bashrc  # or ~/.zshrc if you use zsh

Permission denied errors

Ensure you have proper permissions. The installer may need sudo access:
sudo curl -fsSL https://godrift.ai/install | bash

Update fails

If the automatic update process fails, manually download and install the latest .deb package from the releases page.

Updating Drift CLI

Drift CLI includes automatic update detection. When a new version is available, you’ll see a notification on startup:
ℹ️  A new version (1.1.0) is available. Type /update to install.
Simply run the update command:
drift> /update
Check the releases page to see what’s new in each version.

Build docs developers (and LLMs) love