Installation

Beachball does not have a packaged installer yet. For now, build the bb executable from the repository.

Requirements

Install these tools before you build bb:

• Git
• rustup
• A C compiler and linker

Beachball pins Rust 1.98.0 in agent/rust-toolchain.toml. rustup downloads that toolchain when you build from the agent directory.

Build bb

Clone the repository and build the release executable:

git clone https://github.com/gillesmag/beachball.git
cd beachball/agent
cargo build --locked --release

The build creates target/release/bb. Copy it to a directory on your PATH:

install -d "$HOME/.local/bin"
install -m 0755 target/release/bb "$HOME/.local/bin/bb"
bb --version

If your shell cannot find bb, add $HOME/.local/bin to your PATH and run bb --version again.

Update bb

To install a newer revision, pull the repository and repeat the build and copy commands:

git pull --ff-only
cargo build --locked --release
install -m 0755 target/release/bb "$HOME/.local/bin/bb"

Continue to basic usage to configure a scheduler connection and create an allocation.