# Install clusterawsadm with Homebrew

Home for bootstrapping, AMI, EKS, and other helpers in Cluster API Provider AWS. Version 2.13.0 via Homebrew; verified 2026-07-29.

## 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
- **Version:** 2.13.0
- **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>
- **Last updated:** 2026-07-29T17:54:14Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- clusterawsadm (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 2.13.0
## 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


## Combined YAML source

View the package source record on GitHub. [combined/clusterawsadm.yml](https://github.com/mxcl/pkgdb/blob/main/combined/clusterawsadm.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph
