# Install clusterawsadm with Homebrew

Home for bootstrapping, AMI, EKS, and other helpers in Cluster API Provider AWS. Version 2.11.1 via Homebrew; verified 2026-04-23.

## Install

```sh
sudo av install brew:clusterawsadm
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install clusterawsadm
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:clusterawsadm
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/clusterawsadm>
- **Version:** 2.11.1
- **Source summary:** Home for bootstrapping, AMI, EKS, and other helpers in Cluster API Provider AWS
- **Homepage:** <https://cluster-api-aws.sigs.k8s.io/clusterawsadm/clusterawsadm.html>
- **Repository:** <https://github.com/kubernetes-sigs/cluster-api-provider-aws>
- **Upstream docs:** <https://cluster-api-aws.sigs.k8s.io/clusterawsadm/clusterawsadm.html>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/kubernetes-sigs/cluster-api-provider-aws.git>
- **Last updated:** 2026-04-23T17:47:04Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- clusterawsadm (cli)
- clusterawsadm (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.11.1
- Package-manager updated: 2026-04-23
- Local data: ok
- Upstream repository: https://github.com/kubernetes-sigs/cluster-api-provider-aws
- info: No cached GitHub release or tag data was available.
## Project history and usage

clusterawsadm is the management utility shipped with Kubernetes Cluster API Provider AWS for AWS IAM, AMI, EKS, and controller-administration tasks.

### Project history

Cluster API Provider AWS is the AWS infrastructure provider for Kubernetes Cluster API. Its docs describe CAPA as Kubernetes-native declarative infrastructure for AWS and list clusterawsadm as the CLI tool that provides bootstrapping, AMI, EKS, and controller helpers.

clusterawsadm exists because CAPA needs AWS prerequisites before `clusterctl init --infrastructure aws`: the command can print or create IAM policies, roles, and instance profiles through CloudFormation and can encode credentials for clusterctl.

### Adoption history

The official CAPA documentation says clusterawsadm binaries are attached to each CAPA release and that it can be installed with Homebrew on macOS and Linux.

Its adoption is tied to Cluster API Provider AWS operators: users run it before or around clusterctl initialization to prepare AWS accounts for declarative Kubernetes cluster lifecycle management.

### How it is used

Common usage includes `clusterawsadm bootstrap iam create-cloudformation-stack` to create IAM prerequisites and `clusterawsadm bootstrap credentials encode-as-profile` to provide encoded AWS credentials for `clusterctl init --infrastructure aws`.

The command reference also exposes AMI, bootstrap, controller, EKS, garbage-collection, resource, and version subcommands.

### Why package nerds care

clusterawsadm is a good package-manager example of a narrowly scoped admin companion binary: it is not the core controller, but packagers ship it because real CAPA installs need a local CLI for account bootstrapping and release-aligned assets.

### Timeline

- 2019: Cluster API Provider AWS GitHub releases include v0.1.x and v0.3.x releases.
- 2021: CAPA v1.0.0 was published shortly after Cluster API v1.0.0.
- 2022: CAPA v2.0.0 was published.
- 2026: The generated command reference lists clusterawsadm docs generated by Cobra on June 29, 2026.

### Related projects

- Cluster API Provider AWS is the parent project that ships clusterawsadm.
- Cluster API and clusterctl are the core upstream projects in the workflow.
- kops and kubicorn are named in the CAPA introduction as previous cluster-manager projects whose lessons informed Cluster API-style infrastructure.

### Sources

- <https://cluster-api-aws.sigs.k8s.io/introduction>
- <https://cluster-api-aws.sigs.k8s.io/clusterawsadm/clusterawsadm.html>
- <https://cluster-api-aws.sigs.k8s.io/topics/using-clusterawsadm-to-fulfill-prerequisites>
- <https://github.com/kubernetes-sigs/cluster-api-provider-aws/releases>


## Security Notes

infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- infrastructure mutation or orchestration signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** clusterawsadm
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [clusterctl](https://www.automicvault.com/pkg/brew/clusterctl/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cluster-api, infrastructure, kubernetes.
- [eksctl](https://www.automicvault.com/pkg/brew/eksctl/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure, kubernetes.
- [rosa-cli](https://www.automicvault.com/pkg/brew/rosa-cli/) - Shares av.db curated category or tags: aws, cli, cloud-infrastructure, kubernetes.
- [cdk8s](https://www.automicvault.com/pkg/brew/cdk8s/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [chaoskube](https://www.automicvault.com/pkg/brew/chaoskube/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [click](https://www.automicvault.com/pkg/brew/click/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [cloud-provider-kind](https://www.automicvault.com/pkg/brew/cloud-provider-kind/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [cozyhr](https://www.automicvault.com/pkg/brew/cozyhr/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.

## Combined YAML source

View the package source record on GitHub. [combined/clusterawsadm.yml](https://github.com/automic-vault/db/blob/main/combined/clusterawsadm.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
