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

Quick install

Run the install script

curl -fsSL https://raw.githubusercontent.com/mezmo/aura/main/scripts/install.sh | bash

By default the install script 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:

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.

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:

brew install mezmo/tap/aura

To install the web server, run:

brew install mezmo/tap/aura-web-server

RPM

Add the AURA repository

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

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:

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.

After installing, confirm the version:

aura --version        # or: rpm -q aura

Individual .rpm files are also attached to each GitHub release, for mirroring into an internal repository.

APT

Add the AURA repository

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.

After installing, confirm the version:

aura --version        # or: dpkg -s aura

Individual .deb files are also attached to each GitHub release, for mirroring into an internal repository.

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	aura-web-server-darwin-arm64
macOS (Intel)	aura-darwin-amd64	aura-web-server-darwin-amd64
Linux (x86-64)	aura-linux-amd64	aura-web-server-linux-amd64
Linux (ARM64)	aura-linux-arm64	aura-web-server-linux-arm64

For older versions and checksums.txt, browse the GitHub 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.

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

Next Steps

• Configure and use the CLI at the CLI Reference.
• Run the server at the Web Server Reference.
• Try the containerized stack at the Quickstart.