amd64 and arm64.
Install AURA
- Quick install
- Homebrew
- RPM
- APT
- Binary
Run the install scriptBy 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:Install script environment variables
UpgradeRe-run the install script. It overwrites the existing install in place.
curl -fsSL https://raw.githubusercontent.com/mezmo/aura/main/scripts/install.sh | bash
aura --version
| 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 | Component to install: all, server, or cli. 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) |
Install the
mezmo/tap/aura formula:brew install mezmo/tap/aura
Add the AURA repositoryWrite the repository file. On openSUSE and SLES, use Then install the Substitute Individual
/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
aura package:sudo dnf install aura
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
.rpm files are also attached to each GitHub release, for mirroring into an internal repository.Add the AURA repositoryTo pin a version, qualify the package name: Individual
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
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
.deb files are also attached to each GitHub release, for mirroring into an internal repository.The links below always resolve to the newest release. Each asset is a bare executable with no file extension.
For older versions and
| Platform | aura |
|---|---|
| macOS (Apple Silicon) | aura-darwin-arm64 |
| macOS (Intel) | aura-darwin-amd64 |
| Linux (x86-64) | aura-linux-amd64 |
| Linux (ARM64) | aura-linux-arm64 |
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, and move it somewhere on your PATH.Mezmo code-signs and Apple notarizes the macOS release binaries, 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.