> ## Documentation Index
> Fetch the complete documentation index at: https://mezmo-9a59581a-promptless-aura-wait-for-tool.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install AURA with the install script, a direct binary download, Homebrew, or the APT and RPM package repositories.

AURA supports Linux and macOS on `amd64` and `arm64`.

## Install AURA

<Tabs>
  <Tab title="Quick install">
    **Run the install script**

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/mezmo/aura/main/scripts/install.sh | bash
    ```

    By default the [install script](https://raw.githubusercontent.com/mezmo/aura/main/scripts/install.sh) attempts to install from the AURA package repository through a native package manager, then falls back to Homebrew and finally a direct binary download. The script is configured entirely through the environment variables below.

    After installing, confirm the version:

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

    **Install script environment variables**

    | Variable                | Description                                                                                                                                                                                                                                                                                                                                                                                              | Default        |
    | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
    | `AURA_VERSION`          | Version to install. A leading `v` is optional and is stripped. For `direct`, `latest` follows the GitHub releases/latest redirect to the newest release. For `deb` and `rpm`, a value pins the package version and `latest` lets the package manager choose. Homebrew cannot pin a version: under `auto`, a pinned version skips Homebrew; with `AURA_INSTALL_METHOD=homebrew`, it is a fatal error.     | `latest`       |
    | `AURA_INSTALL_METHOD`   | How to install: `auto`, `homebrew`, `direct`, `deb`, or `rpm`, lowercase (for example `deb`, not `DEB`). Any other value is a fatal error.                                                                                                                                                                                                                                                               | `auto`         |
    | `AURA_INSTALL_PATH`     | Install directory for the `direct` method, created if it does not exist. Under `auto`, setting it skips Homebrew, Debian, and RPM in favor of a direct install. Combining it with an explicit `homebrew`, `deb`, or `rpm` method is a fatal error.                                                                                                                                                       | `~/.local/bin` |
    | `AURA_COMPONENT`        | Which binaries to install: `all`, `server`, or `cli`. `all` or `cli` installs the `aura` CLI. `all` or `server` installs `aura-web-server`. Any other value is a fatal error.                                                                                                                                                                                                                            | `all`          |
    | `AURA_REQUIRE_CHECKSUM` | `direct` method only. When `1` (the default), a missing checksums file or a missing entry for an asset is a fatal error; set it to `0` to downgrade those to a warning. A checksum mismatch, or the absence of any checksum tool (`sha256sum`, `shasum`, or `openssl`) when there is a checksum to verify, is always fatal regardless of this setting. Any value other than `0` or `1` is a fatal error. | `1`            |
    | `AURA_CHECKSUMS`        | `direct` method only. Path to a local `checksums.txt` file. When set, the script verifies against this file instead of downloading `checksums.txt` from the release.                                                                                                                                                                                                                                     | (unset)        |

    **Upgrade**

    Re-run the install script. It overwrites the existing install in place.
  </Tab>

  <Tab title="Homebrew">
    The tap provides one formula per component: `mezmo/tap/aura` (base AURA, all-in-one) and `mezmo/tap/aura-web-server` (daemon). To install base AURA, run:

    ```bash theme={null}
    brew install mezmo/tap/aura
    ```

    To install the web server, run:

    ```bash theme={null}
    brew install mezmo/tap/aura-web-server
    ```
  </Tab>

  <Tab title="RPM">
    **Add the AURA repository**

    Write the repository file. On openSUSE and SLES, use `/etc/zypp/repos.d/mezmo-aura.repo` instead:

    ```bash theme={null}
    sudo tee /etc/yum.repos.d/mezmo-aura.repo > /dev/null <<'EOF'
    [mezmo-aura]
    name=mezmo-aura
    baseurl=https://dl.cloudsmith.io/public/mezmo/aura/rpm/any-distro/any-version/$basearch
    repo_gpgcheck=1
    gpgcheck=1
    enabled=1
    autorefresh=1
    gpgkey=https://dl.cloudsmith.io/public/mezmo/aura/gpg.05C8AD333177EB1F.key
    sslverify=1
    metadata_expire=300
    type=rpm-md
    EOF
    ```

    Then install the packages you want:

    ```bash theme={null}
    sudo dnf install aura aura-web-server
    ```

    Substitute `microdnf`, `yum`, or `zypper` if that is what the system uses.

    To pin a version, append it to the package name (`dnf install aura-0.1.18`). `zypper` uses `aura=0.1.18` instead, and needs `sudo zypper --gpg-auto-import-keys refresh mezmo-aura` once to trust the signing key.

    To list the versions the repository carries, run `dnf --showduplicates list aura` (`zypper search -s aura`), or browse the [Cloudsmith package list](https://cloudsmith.io/~mezmo/repos/aura/packages/).

    After installing, confirm the version:

    ```bash theme={null}
    aura --version        # or: rpm -q aura
    ```

    Individual `.rpm` files are also attached to each [GitHub release](https://github.com/mezmo/aura/releases), for mirroring into an internal repository.
  </Tab>

  <Tab title="APT">
    **Add the AURA repository**

    ```bash theme={null}
    sudo apt-get install -y ca-certificates curl gnupg

    curl -fsSL https://dl.cloudsmith.io/public/mezmo/aura/gpg.05C8AD333177EB1F.key \
      | sudo gpg --dearmor -o /usr/share/keyrings/mezmo-aura-archive-keyring.gpg

    # This one source line is correct on every Debian and Ubuntu release
    echo 'deb [signed-by=/usr/share/keyrings/mezmo-aura-archive-keyring.gpg] https://dl.cloudsmith.io/public/mezmo/aura/deb/debian bookworm main' \
      | sudo tee /etc/apt/sources.list.d/mezmo-aura.list

    sudo apt-get update
    sudo apt-get install -y aura aura-web-server
    ```

    To pin a version, qualify the package name: `sudo apt-get install aura=0.1.18`.

    To list the versions the repository carries, run `apt-cache madison aura`, or browse the [Cloudsmith package list](https://cloudsmith.io/~mezmo/repos/aura/packages/).

    After installing, confirm the version:

    ```bash theme={null}
    aura --version        # or: dpkg -s aura
    ```

    Individual `.deb` files are also attached to each [GitHub release](https://github.com/mezmo/aura/releases), for mirroring into an internal repository.
  </Tab>

  <Tab title="Binary">
    The links below always resolve to the newest release. Each asset is a bare executable with no file extension.

    | Platform              | `aura` CLI                                                                                    | `aura-web-server`                                                                                                   |
    | --------------------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
    | macOS (Apple Silicon) | [aura-darwin-arm64](https://github.com/mezmo/aura/releases/latest/download/aura-darwin-arm64) | [aura-web-server-darwin-arm64](https://github.com/mezmo/aura/releases/latest/download/aura-web-server-darwin-arm64) |
    | macOS (Intel)         | [aura-darwin-amd64](https://github.com/mezmo/aura/releases/latest/download/aura-darwin-amd64) | [aura-web-server-darwin-amd64](https://github.com/mezmo/aura/releases/latest/download/aura-web-server-darwin-amd64) |
    | Linux (x86-64)        | [aura-linux-amd64](https://github.com/mezmo/aura/releases/latest/download/aura-linux-amd64)   | [aura-web-server-linux-amd64](https://github.com/mezmo/aura/releases/latest/download/aura-web-server-linux-amd64)   |
    | Linux (ARM64)         | [aura-linux-arm64](https://github.com/mezmo/aura/releases/latest/download/aura-linux-arm64)   | [aura-web-server-linux-arm64](https://github.com/mezmo/aura/releases/latest/download/aura-web-server-linux-arm64)   |

    For older versions and `checksums.txt`, browse the [GitHub Releases](https://github.com/mezmo/aura/releases) page.

    Each download arrives non-executable and keeps its platform suffix, so make it executable, rename it to `aura` or `aura-web-server`, and move it somewhere on your `PATH`.

    <Note>Mezmo code-signs and Apple notarizes the macOS release binaries — both the `aura` CLI and `aura-web-server`, for Intel (`amd64`) and Apple Silicon (`arm64`). They run without the Gatekeeper "unidentified developer" prompt, even when downloaded through a web browser from the [GitHub Releases](https://github.com/mezmo/aura/releases) page.</Note>
  </Tab>
</Tabs>

## Next Steps

* Configure and use the CLI at the [CLI Reference](/aura/cli-reference).
* Run the server at the [Web Server Reference](/aura/web-server-reference).
* Try the containerized stack at the [Quickstart](/aura/quickstart).