Skip to content

Installation

Platform Method
Linux (x86_64, aarch64), macOS (Apple Silicon) Download from latest release, extract onto $PATH.
Any platform with Rust cargo install auberge (installs to ~/.cargo/bin/).
Windows Not supported — Ansible requires a Unix control node. Use WSL2.
Terminal window
auberge --version # verify
cargo install auberge --force # update
cargo uninstall auberge # remove

No platform-specific dependencies on Linux or macOS.

Terminal window
# ~/.bashrc — after auberge is on PATH (e.g. after mise activation)
source <(auberge completions bash)

The script is regenerated by the installed binary on every shell start (~10 ms), so it can never drift from the version you actually run. Zsh, fish, elvish, and powershell work the same way — see completions for the file-drop alternative and its staleness caveat.

Continue: Quick Start · First Deployment