Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ara-home/ara/llms.txt

Use this file to discover all available pages before exploring further.

Ara ships as a single self-contained binary named ara. There are no runtime dependencies, no Node.js version to manage, and no global node_modules to worry about. The recommended way to get it is to download a pre-built release from GitHub. If you prefer to build from source, that works too — you just need a Rust toolchain.
The seccomp-BPF sandbox used by ara run is Linux x86_64 only. On macOS and Windows, ara run executes your scripts without syscall restrictions — all other commands (install, add, analyze, x, gc) work identically across all three platforms.

​
Download from GitHub Releases

Pre-built binaries are published to github.com/ara-home/ara/releases for every tagged version. The current release is v0.11.0. Five targets are available:
TargetPlatform
x86_64-unknown-linux-gnuLinux x86_64 (glibc)
x86_64-unknown-linux-muslLinux x86_64 (musl / Alpine)
aarch64-apple-darwinmacOS Apple Silicon
x86_64-apple-darwinmacOS Intel
x86_64-pc-windows-msvcWindows x86_64

​
Linux (x86_64)

1

Download the binary archive

Go to the latest release page and download the archive for your Linux variant:
  • ara-x86_64-unknown-linux-gnu.tar.gz — for standard distros (Ubuntu, Debian, Fedora, Arch)
  • ara-x86_64-unknown-linux-musl.tar.gz — for Alpine Linux or any musl-based system
# Example for glibc Linux — replace the version tag as needed
curl -LO https://github.com/ara-home/ara/releases/download/v0.11.0/ara-x86_64-unknown-linux-gnu.tar.gz
2

Extract the archive

tar -xzf ara-x86_64-unknown-linux-gnu.tar.gz
3

Move the binary into your PATH

sudo mv ara /usr/local/bin/ara
sudo chmod +x /usr/local/bin/ara
4

Verify the installation

ara --version
Expected output:
ara 0.11.0

​
macOS

1

Download the binary archive

From the latest release page, download the archive that matches your Mac:
  • ara-aarch64-apple-darwin.tar.gz — Apple Silicon (M1, M2, M3, M4)
  • ara-x86_64-apple-darwin.tar.gz — Intel Mac
# Example for Apple Silicon
curl -LO https://github.com/ara-home/ara/releases/download/v0.11.0/ara-aarch64-apple-darwin.tar.gz
2

Extract the archive

tar -xzf ara-aarch64-apple-darwin.tar.gz
3

Move the binary into your PATH

mv ara /usr/local/bin/ara
chmod +x /usr/local/bin/ara
4

Allow the binary on first run (Gatekeeper)

macOS may quarantine the downloaded binary. To clear the quarantine flag:
xattr -d com.apple.quarantine /usr/local/bin/ara
5

Verify the installation

ara --version
On macOS, ara run executes scripts without any sandbox restrictions. The seccomp-BPF profiles (hermetic, restricted) are Linux-only and degrade to the open (unrestricted) profile on macOS. All other commands are fully functional.

​
Windows (x86_64)

1

Download the binary archive

From the latest release page, download:
  • ara-x86_64-pc-windows-msvc.zip
2

Extract the archive

Right-click the .zip file and select Extract All, or use PowerShell:
Expand-Archive ara-x86_64-pc-windows-msvc.zip -DestinationPath .
3

Add the binary to your PATH

Move ara.exe to a directory that is already on your PATH, such as C:\Windows\System32, or add its current directory to your user PATH via System Properties → Environment Variables.
4

Verify the installation

ara --version
On Windows, ara run executes scripts without sandbox restrictions. Seccomp-BPF is Linux-specific and has no Windows equivalent yet. All other commands work normally.

​
Build from source

Building from source requires a working Rust toolchain. If you do not have Rust installed, get it from rustup.rs.
1

Clone the repository

git clone https://github.com/ara-home/ara.git
cd ara
2

Build and install the binary

The Cargo manifest for the ara binary lives in src/Cargo.toml. Install it directly to your Cargo bin directory (~/.cargo/bin by default, which should already be on your PATH if you installed Rust via rustup):
cargo install --path src/
3

Verify the installation

ara --version
For a faster build that skips dev-dependencies and benchmarks, you can also compile in release mode and copy the binary manually:
cargo build --release --manifest-path src/Cargo.toml
sudo cp target/release/ara /usr/local/bin/ara

​
Shell completion (optional)

Ara uses clap for its CLI, which can generate shell completions. Completion generation is not yet exposed as a built-in subcommand, but it is on the roadmap.

​
Next steps

Once ara --version prints successfully, head over to the Quickstart to run your first secure install.

Build docs developers (and LLMs) love

Get started for freeTalk to us