Installation

v0.2.0 Latest Release

Pre-built Binaries

The fastest way to install Aranet CLI is using pre-built binaries:

brew tap cameronrye/aranet
brew install aranet

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/cameronrye/aranet/releases/latest/download/aranet-cli-installer.sh | sh

irm https://github.com/cameronrye/aranet/releases/latest/download/aranet-cli-installer.ps1 | iex

Download binaries directly from GitHub Releases:

macOS (Apple Silicon)

macOS (Intel)

Linux (x86_64)

Windows (x86_64)

Run aranet-service in a container (requires BLE access on the host):

docker compose up -d

Or use the full monitoring stack with Prometheus and Grafana:

docker compose -f docker/docker-compose.yml up -d

See Service Deployment for configuration details.

Install using Cargo (requires Rust toolchain):

cargo install aranet-cli

This installs the aranet executable.

Alternatively, build from source for the latest development version:

Clone the repository

git clone https://github.com/cameronrye/aranet.git
cd aranet

No additional dependencies required. Bluetooth access will prompt for permission on first use.

Install the D-Bus development library:

# Debian/Ubuntu
sudo apt-get install libdbus-1-dev

# Fedora
sudo dnf install dbus-devel

# Arch
sudo pacman -S dbus

To install the CLI to your Cargo bin directory:

cargo install --path crates/aranet-cli

This allows you to run aranet from anywhere:

aranet scan

Generate shell completions for your shell:

aranet completions bash > ~/.local/share/bash-completion/completions/aranet

aranet completions zsh > ~/.zfunc/_aranet

aranet completions fish > ~/.config/fish/completions/aranet.fish

Add aranet-core to your Cargo.toml:

[dependencies]
aranet-core = "0.2"

Check that everything is working:

# Show version
aranet --version

# Run BLE diagnostics
aranet doctor

# Scan for devices (requires Bluetooth)
aranet scan --timeout 5