Install hudl

hudl ships as a single ~12 MB static Go binary. No Python, no Node, no runtime — just one file on your PATH.

macOS / Linux

curl -fsSL https://get.huddle01.com/hudl | sh

The installer detects your OS and architecture, downloads the correct binary to ~/.hudl/bin, and adds it to your PATH.

brew install huddle01/tap/hudl

Homebrew handles PATH and upgrades automatically. Run brew upgrade hudl to update.

irm https://get.huddle01.com/hudl.ps1 | iex

Or download the MSI installer from the releases page.

Run hudl in a container, mounting your config directory for persistent auth:

docker run --rm -it -v ~/.hudl:/root/.hudl ghcr.io/huddle01/hudl:latest vm list

This is useful for CI environments where you don't want to install the binary globally.

Requires Go 1.22+:

go install github.com/Huddle01/hudl/cmd/hudl@latest

hudl --version
# hudl 1.0.0  •  built 2026-04-07  •  go1.24

To update to the latest version, re-run the install command for your platform:

# macOS / Linux
curl -fsSL https://get.huddle01.com/hudl | sh

# Homebrew
brew upgrade hudl

Once installed, authenticate and set your workspace context:

hudl login --token mk_xxx
hudl ctx use acme-prod
hudl ctx region eu2
hudl vm list    # verify everything works

See Authentication for the full auth setup, or jump straight to Virtual Machines to start provisioning.