A macOS app for creating, testing, and cleaning up disposable Rancher environments.
- Deploy Rancher on AWS RKE2, hosted/tenant K3s, or Linode Docker.
- Follow runs, inspect clusters, collect kubeconfigs, and clean up resources.
- Explore images and Helm charts, run validation tests, and save issue evidence.
- Use local k3d and Steve labs without provisioning cloud infrastructure.
Requires macOS 12+ and Homebrew. Supports Apple Silicon and Intel.
brew tap hashicorp/tap
brew trust --formula hashicorp/tap/terraform
brew install --cask brudnak/tap/rancher-runwayThe install includes Terraform, Helm 4, kubectl, and GitHub CLI. Core setup and cleanup do not require a source checkout, Go, or Node.js.
Open Rancher Runway from Applications. If macOS blocks the first launch, follow the first-launch instructions.
- Open Setup and import a
tool-config.ymlor fill in the configuration. - Choose your environment and Rancher version, check credentials, and select Resolve & review plan before starting.
- Follow progress in Runs and inspect the environment in Clusters.
- Use Destroy when finished.
Cloud runs need credentials for the selected provider; Linode Docker also uses AWS Route53 for DNS. See the desktop guide for details.
Destroy live infrastructure before deleting workspace data or using
brew uninstall --zap rancher-runway; that data is needed for cleanup.
Requires Xcode Command Line Tools, Go as specified in go.mod, and Node.js/npm.
make setup # Build and install the desktop app
make test-regression # Run local checks without provisioning infrastructureSee the development guide for build targets and architecture.