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

# Overview

> Install and get started with the Mesa CLI.

<Warning title="Work in Progress">
  This page is a draft and may be incomplete or change significantly. If you have questions, reach out to us on [Discord](https://discord.gg/mesa) or [open an issue](https://github.com/mesa-dot-dev/mesa/issues).
</Warning>

The Mesa CLI lets you mount repositories as local directories, manage configurations, and interact with Mesa from the command line.

## Installation

```bash theme={null}
curl -fsSL https://mesa.dev/install.sh | sh
```

This installs the latest release and keeps it updatable through your package manager (Homebrew on macOS; apt/apk/dnf on Linux).

### Installing a specific version (Linux only)

On Linux, you can pin a specific version — for example to stay on a known-good release while you migrate past a breaking change:

```bash theme={null}
curl -fsSL https://mesa.dev/install.sh | sh -s -- --version 0.36.0
```

This installs the exact version through your package manager (apt/apk/dnf) using the same Buildkite repository as a standard install, which retains all historical releases. On apt the package is also held with `apt-mark hold mesa` so the pin survives a later `apt upgrade`. On Alpine the pin is recorded in `/etc/apk/world` and respected on upgrade. On dnf, use the `versionlock` plugin if you need to prevent `dnf upgrade` from moving off the pin.

Version pinning is not supported on macOS — Homebrew manages mesa and always tracks the latest release.

For detailed configuration options, see [Configuration](/content/reference/mesa-cli-configuration). For a full list of commands, see [Commands](/content/reference/mesa-cli).