Amaru is still in an exploratory phase. Our development strategy favors early integration of components, so that progress is instantly visible, even though features might be limited or incomplete.
You can install Amaru "manually" by downloading an archive with pre-compiled (statically linked) executables for all usual platforms (Linux, macOS & Windows). The archives come with shell completions scripts.
See either:
Alternatively, Amaru also comes pre-packaged for a few platforms.
docker pull ghcr.io/pragma-org/amaru:v10.11.20260827Important
The tag :latest refers to the latest nightly build; not the latest release.
brew tap pragma-org/amaru https://github.com/pragma-org/amaru && brew trust --tap pragma-org/amaru
brew install amaru
nix profile install --no-write-lock-file github:pragma-org/amaru#amaru
VERSION=10.11.20260827 ARCH=x86_64; curl -fsSL -o amaru-$VERSION-linux-$ARCH.deb "https://github.com/pragma-org/amaru/releases/download/v$VERSION/amaru-$VERSION-linux-$ARCH.deb"
VERSION=10.11.20260827 ARCH=x86_64; sudo apt install ./amaru-$VERSION-linux-$ARCH.debAlso available for ARCH=aarch64.
The Debian package installs a systemd unit and reads overrides from /etc/default/amaru.
VERSION=10.11.20260827 ARCH=x86_64; curl -fsSL -o amaru-$VERSION-linux-$ARCH.rpm "https://github.com/pragma-org/amaru/releases/download/v$VERSION/amaru-$VERSION-linux-$ARCH.rpm"
VERSION=10.11.20260827 ARCH=x86_64; sudo dnf install ./amaru-$VERSION-linux-$ARCH.rpmAlso available for ARCH=aarch64.
The RPM package installs a systemd unit and reads overrides from /etc/sysconfig/amaru.
cargo build --releaseTip
Prefer not to install Rust locally? We provide a Docker-based build and run path. See docker/README.md for instructions on using Docker instead.
- (First time) Bootstrap the node:
amaru node bootstrap --network=mainnet- (Optional) Setup observability backends:
docker compose -f monitoring/docker-compose.yml up -d- Run Amaru:
amaru node run --network=mainnetTip
To ensure logs are forwarded to an OpenTelemetry backend, set AMARU_WITH_OPEN_TELEMETRY=true:
amaru --with-open-telemetry node run --network=mainnetSee also amaru node run --help for more options.
See monitoring/README.md.
⛵ Roadmap | 📐 Contributing | 📰 ChangeLog
