> ## 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.

<Note>
  The Mesa CLI runs on **Linux only**. On other platforms, use a Linux sandbox or container; see [Sandboxes](/content/integrations/sandboxes/daytona).
</Note>

## Installation

Install on Linux, pinning the version you want:

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

This installs the exact version through your package manager (apt/apk/dnf), 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.

Check back periodically and move the pin forward to pick up fixes and new features.

<Note>
  We highly recommend pinning a version so an upgrade never moves you onto breaking changes unexpectedly. If you want to track the newest release anyway, pass `--version=latest`.
</Note>

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