Install
rackctl is a single static Go binary. It ships for macOS and Linux, on both
amd64 and arm64.
Install script
Section titled “Install script”The quickest path. Downloads the release archive for your platform, verifies it
against the published checksums.txt, and installs rackctl to /usr/local/bin.
curl -fsSL rackctl.com/install | shPrefer 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.
Homebrew
Section titled “Homebrew”brew install rackctl/tap/rackctlThe formula in rackctl/homebrew-tap
is published automatically by goreleaser on every release.
From source
Section titled “From source”Requires Go 1.26 or newer.
git clone https://github.com/rackctl/rackctlcd rackctlmake build # -> ./dist/rackctl# or install onto your PATH:go install github.com/rackctl/rackctl@latestVerify
Section titled “Verify”rackctl versionPrerequisites
Section titled “Prerequisites”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.