Install osdctl with Homebrew

Project links

• Homepage
• Upstream docs
• Package manager page

Commands and aliases

• osdctl

Project history

GitHub records openshift/osdctl as created on 2020-06-03. The README describes a build-and-release workflow using Go, make, GoReleaser, GitHub releases, a Homebrew tap, and generated command documentation after releases.

The command examples show the package expanding from AWS account custom-resource operations into a broader managed-cluster operations toolbox: account reset/status/list, IAM credential rotation, Hive ClusterDeployment inspection, cluster break-glass access, Dynatrace log gathering, service-log posting, OCM environment management, RHOBS commands, and evidence collection.

Adoption history

Public adoption evidence is mainly internal-platform shaped: osdctl lives under the openshift GitHub organization, is installed from an OpenShift Online SRE tools Homebrew tap in the README, and its command set is full of Red Hat/OpenShift service-operation concepts. Homebrew core also packages it as a CLI tool for managed OpenShift clusters.

The release stream shows active operational packaging, with v0.59.0, v0.60.0, and v0.61.0 publishing Darwin and Linux tarballs plus checksum files. That pattern fits an SRE tool expected to be installed on operator workstations and automation hosts.

How it is used

SREs use osdctl to inspect and mutate account resources, generate AWS console URLs, rotate secrets, display operator metrics, manage multiple cluster login environments, perform break-glass access and cleanup, post service logs, query organizations, run etcd health checks, and collect evidence for feature testing.

The tool creates or reads configuration under ~/.config/osdctl and ~/.osdctl.yaml. Its env subcommands help operators maintain separate KUBECONFIG and OCM_CONFIG contexts for different clusters, which is a practical workflow detail for managed-cluster support.

Why package nerds care

osdctl is significant as an example of a large operational CLI whose package boundary is shaped by SRE workflows rather than by one public API. It collects many small runbook actions into one installable binary, which explains both its breadth and its frequent release cadence.

For package metadata, it is also a good reminder that some Homebrew formulas are not consumer developer tools; they are distribution channels for specialized operations software used by a specific platform team.

Timeline

• 2020-06-03: GitHub repository created.
• 2026-05-18: v0.59.0 release published with multi-platform osdctl artifacts.
• 2026-06-01: v0.60.0 release published.
• 2026-06-26: v0.61.0 release published with Darwin and Linux tarballs plus sha256sum.txt.

Related projects

• aws-account-operator is explicitly called out in the README as an early supported focus. osdctl also interacts with OpenShift Dedicated, OCM, Hive, Backplane, RHOBS, Dynatrace, and OpenShift/Kubernetes cluster APIs through its command set.

Sources

• https://api.github.com/repos/openshift/osdctl
• https://api.github.com/repos/openshift/osdctl/releases
• https://docs.redhat.com/en/documentation/openshift_dedicated/4/html-single/cli_tools/index
• https://formulae.brew.sh/formula/osdctl
• https://github.com/openshift/aws-account-operator
• https://github.com/openshift/osdctl
• https://raw.githubusercontent.com/openshift/osdctl/master/README.md