Installation Methods

Installer script

The recommended method. Works on Linux and macOS:

curl -fsSL https://boks.sh/install | sh

The script:

1. Detects your OS and architecture
2. Downloads the matching binary from the latest release
3. Verifies the SHA256 checksum
4. Installs to ~/.local/bin/boks
5. Prints a PATH hint if ~/.local/bin is not already in your path

Manual install

Download the binary directly from the Codeberg releases page, verify the checksum, extract, and place it somewhere on your PATH:

# Example for Linux x86-64
RELEASE=v0.1.0
ARCHIVE=boks-${RELEASE}-x86_64-unknown-linux-musl.tar.gz
curl -fsSL "https://codeberg.org/marqvi/boks/releases/download/${RELEASE}/${ARCHIVE}" -o /tmp/${ARCHIVE}
curl -fsSL "https://codeberg.org/marqvi/boks/releases/download/${RELEASE}/${ARCHIVE}.sha256" -o /tmp/${ARCHIVE}.sha256
cd /tmp && sha256sum -c ${ARCHIVE}.sha256
tar -xzf ${ARCHIVE} -C ~/.local/bin
chmod +x ~/.local/bin/boks

Available targets:

Build from source

Requires Rust and Cargo (rustup.rs):

git clone https://codeberg.org/marqvi/boks.git
cd boks
cargo build --release
cp target/release/boks ~/.local/bin/