> ## Documentation Index
> Fetch the complete documentation index at: https://docs.godrift.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> System requirements and how to install Drift CLI

## System Requirements

Before installing, make sure your system meets the requirements. See the full [System Requirements](/reference/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`.

## Quick Install (Recommended)

The fastest way to install Drift CLI:

```bash theme={null}
curl -fsSL https://godrift.ai/install | bash
```

Once installed, restart your terminal (or use the integrated terminal in VS Code or Cursor) and run:

```bash theme={null}
source ~/.bashrc  # or ~/.zshrc
```

You should see:

```
Get started with:
  drift --help        Show help
  drift init          Initialize project
  drift simulate      Start simulation
```

## 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](https://github.com/godrift-ai/drift-releases/releases)

2. Install with `dpkg`:

```bash theme={null}
sudo dpkg -i drift-cli_*_amd64.deb
```

3. To start, run:

```bash theme={null}
drift
```

## Updating

Drift CLI detects new versions automatically. When an update is available, you'll see a notification on startup:

```
ℹ️ A new version (x.x.x) is available. Type /update to install.
```

To update, simply run inside the Drift prompt:

```
drift> /update
```

Or manually download and install the latest `.deb` from [Releases](https://github.com/godrift-ai/drift-releases/releases).

## Troubleshooting

### "Command not found: drift"

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

```bash theme={null}
source ~/.bashrc  # or ~/.zshrc
```

### Update fails

Manually download the latest `.deb` package from the [releases page](https://github.com/godrift-ai/drift-releases/releases) 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:

```bash theme={null}
sudo dpkg -r drift-cli
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/getting-started/quickstart">
    Install complete? Jump into the quickstart to build your first simulation.
  </Card>

  <Card title="Commands Reference" icon="terminal" href="/reference/commands">
    Learn what `drift init` and `drift simulate` do and when to use them.
  </Card>
</CardGroup>