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

# Installation

> Complete installation guide for Terramind across all platforms

## Quick Install (Recommended)

The easiest way to install Terramind on macOS or Linux:

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

This script will automatically:

* Detect your operating system and architecture
* Download the correct binary
* Install it to the appropriate location
* Make it available in your PATH

After installation, restart your terminal and verify:

```bash theme={null}
terramind --version
```

## Package Managers

Alternatively, install via your preferred package manager:

<CodeGroup>
  ```bash npm theme={null}
  npm install -g terramind
  ```

  ```bash pnpm theme={null}
  pnpm add -g terramind
  ```

  ```bash yarn theme={null}
  yarn global add terramind
  ```

  ```bash bun theme={null}
  bun add -g terramind
  ```
</CodeGroup>

## Platform-Specific Installation

### macOS

#### Homebrew

```bash theme={null}
brew tap terramind-com/tap
brew install terramind-com/tap/terramind
```

#### Install Script

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

### Linux

#### Install Script (Recommended)

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

#### Manual Download

<CodeGroup>
  ```bash ARM64 theme={null}
  curl -LO https://registry.npmjs.org/terramind-linux-arm64/-/terramind-linux-arm64-VERSION.tgz
  tar -xzf terramind-linux-arm64-VERSION.tgz
  sudo mv package/bin/terramind /usr/local/bin/
  ```

  ```bash x64 theme={null}
  curl -LO https://registry.npmjs.org/terramind-linux-x64/-/terramind-linux-x64-VERSION.tgz
  tar -xzf terramind-linux-x64-VERSION.tgz
  sudo mv package/bin/terramind /usr/local/bin/
  ```
</CodeGroup>

### Windows

#### Chocolatey

```powershell theme={null}
choco install terramind
```

#### Scoop

```powershell theme={null}
scoop bucket add extras
scoop install extras/terramind
```

#### npm

```powershell theme={null}
npm install -g terramind
```

## Verify Installation

After installation, verify that Terramind is working:

```bash theme={null}
terramind --version
```

You should see the version number displayed.

## Updating Terramind

### Using Install Script

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

### Using Package Managers

<CodeGroup>
  ```bash npm theme={null}
  npm update -g terramind
  ```

  ```bash pnpm theme={null}
  pnpm update -g terramind
  ```

  ```bash yarn theme={null}
  yarn global upgrade terramind
  ```

  ```bash bun theme={null}
  bun update -g terramind
  ```

  ```bash Homebrew theme={null}
  brew upgrade terramind-com/tap/terramind
  ```

  ```powershell Chocolatey theme={null}
  choco upgrade terramind
  ```

  ```powershell Scoop theme={null}
  scoop update terramind
  ```
</CodeGroup>

### Using Built-in Upgrade Command

```bash theme={null}
terramind upgrade
```

This will check for updates and upgrade to the latest version.

## System Requirements

* **Operating System**: macOS, Linux, or Windows
* **Architecture**: ARM64 or x64
* **Node.js**: 18.x or higher (only for npm installation)

## Troubleshooting

<AccordionGroup>
  <Accordion title="Command not found">
    If you get a "command not found" error after installation:

    1. Make sure the installation completed successfully
    2. Try closing and reopening your terminal
    3. Check that the binary is in your PATH
    4. Run the install script again: `curl -fsSL https://terramind.com/install | bash`
  </Accordion>

  <Accordion title="Permission denied">
    If you encounter permission errors:

    * The install script handles permissions automatically
    * For npm installations, try using `sudo` for global installations
    * Or install without `-g` flag in a local project
    * Consider using a Node version manager (nvm, fnm) to avoid permission issues
  </Accordion>

  <Accordion title="Version mismatch">
    If the version command shows an old version:

    1. Clear package cache: `npm cache clean --force`
    2. Uninstall: `npm uninstall -g terramind`
    3. Reinstall using the install script: `curl -fsSL https://terramind.com/install | bash`
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Run your first Terramind command
  </Card>

  <Card title="CLI Commands" icon="terminal" href="/cli/commands">
    Learn about all available commands
  </Card>
</CardGroup>