Installation

Quick Install

The easiest way to install brdz is using our installation script:

curl -fsSL https://brdz-releases-public.s3.eu-central-1.amazonaws.com/install.sh | bash

This script will:

Detect your operating system and architecture
Download the appropriate binary
Install it to /usr/local/bin/brdz
Make it executable

Verify Installation

After installation, verify that brdz is working correctly:

brdz --help

You should see the brdz help output with available commands.

Alternative: Manual Installation

If you prefer to install manually or the script doesn’t work for your system:

macOS / Linux

Download the latest binary for your architecture:

# macOS (Apple Silicon)
curl -L https://brdz-releases-public.s3.eu-central-1.amazonaws.com/latest/brdz-darwin-arm64 -o brdz

# macOS (Intel)
curl -L https://brdz-releases-public.s3.eu-central-1.amazonaws.com/latest/brdz-darwin-amd64 -o brdz

# Linux (amd64)
curl -L https://brdz-releases-public.s3.eu-central-1.amazonaws.com/latest/brdz-linux-amd64 -o brdz

# Linux (arm64)
curl -L https://brdz-releases-public.s3.eu-central-1.amazonaws.com/latest/brdz-linux-arm64 -o brdz

Install the binary:

# Make it executable
chmod +x brdz

# Move to a directory in your PATH
sudo mv brdz /usr/local/bin/

Or use the built-in installer if you’ve already downloaded the binary:

./brdz install

Windows

Using WSL (Recommended)

We recommend using Windows Subsystem for Linux (WSL) and following the Linux installation instructions above.

Native Windows

Download the Windows binary:

# Download using PowerShell
Invoke-WebRequest -Uri "https://brdz-releases-public.s3.eu-central-1.amazonaws.com/latest/brdz-windows-amd64.exe" -OutFile "brdz.exe"

# Add to your PATH or run directly

Updating brdz

To update to the latest version, you can use the built-in update command:

brdz update

Or re-run the installation script:

curl -fsSL https://brdz-releases-public.s3.eu-central-1.amazonaws.com/install.sh | bash

Next Steps

Now that you have brdz installed, continue to the Quick Start Guide to create your first deployment.