Skip to main content
This page is a draft and may be incomplete or change significantly. If you have questions, reach out to us on Discord or open an issue.
The Mesa CLI lets you mount repositories as local directories, manage configurations, and interact with Mesa from the command line.

​
Installation

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: 
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. For a full list of commands, see Commands.