Skip to content

Install

rackctl is a single static Go binary. It ships for macOS and Linux, on both amd64 and arm64.

The quickest path. Downloads the release archive for your platform, verifies it against the published checksums.txt, and installs rackctl to /usr/local/bin.

Terminal window
curl -fsSL rackctl.com/install | sh

Prefer to read before you run? The script lives in the repo at scripts/install.sh. Pipe it to a file, inspect it, then run it.

Terminal window
brew install rackctl/tap/rackctl

The formula in rackctl/homebrew-tap is published automatically by goreleaser on every release.

Requires Go 1.26 or newer.

Terminal window
git clone https://github.com/rackctl/rackctl
cd rackctl
make build # -> ./dist/rackctl
# or install onto your PATH:
go install github.com/rackctl/rackctl@latest
Terminal window
rackctl version

rackctl orchestrates the tools you already use to run a platform — it doesn’t bundle them. Install these and make sure they’re on your PATH:

Tool Used for
tofu OpenTofu — provisions the AWS substrate
terragrunt Wraps the landing-zone Terragrunt components
kubectl Talks to the EKS cluster
helm Installs the operator and addon charts
aws AWS CLI — identity, quotas, and API calls
git Clones and manages the platform repos
gh GitHub CLI — forks the org repos

Run rackctl doctor to confirm they’re all present and that your AWS identity resolves before you provision anything.

Head to the quickstart to write your first rackctl.yaml.