# Install karmadactl with Homebrew

CLI for Karmada control plane. Version 1.18.2 via Homebrew; verified 2026-07-31.

## Install

```sh
sudo av install brew:karmadactl
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install karmadactl
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:karmadactl
- **Package manager:** Homebrew
- **Version:** 1.18.2
- **Source summary:** CLI for Karmada control plane
- **Homepage:** <https://karmada.io/>
- **Repository:** <https://github.com/karmada-io/karmada>
- **Last updated:** 2026-07-31T12:48:46Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- karmadactl (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.18.2
## Project history and usage

karmadactl is the command-line interface for Karmada, the Kubernetes Armada multi-cluster and multi-cloud control plane.

### Project history

Karmada was built to let users run Kubernetes-native applications across multiple clusters and clouds without changing the applications. karmadactl is the operator-facing CLI for that control plane, covering installation, member-cluster registration, resource inspection, propagation, and lifecycle commands.

### Adoption history

Karmada entered CNCF as a sandbox project on September 14, 2021 and moved to CNCF Incubating on December 12, 2023. The CNCF project page records a first commit on November 10, 2020, and Karmada documentation states that v1.0.0 was released in December 2021.

### How it is used

Operators use karmadactl init to install a Karmada control plane, join or register member clusters, apply resources into the control plane, inspect resources across member clusters, and promote resources from legacy clusters. Its command surface mirrors kubectl-style administration but targets a federated control plane.

### Why package nerds care

karmadactl matters because it packages a multi-cluster control-plane interface as a familiar single binary. For package maintainers and Kubernetes operators, it is another example of the kubectl-adjacent CLI pattern: one executable exposes a large API surface generated by Cobra docs and tied to a fast-moving controller project.

### Timeline

- 2020-11-10: CNCF project metadata records Karmada's first commit.
- 2021-09-14: Karmada was accepted into CNCF.
- 2021-12: Karmada documentation records v1.0.0 as released in December 2021.
- 2023-12-12: Karmada moved to CNCF Incubating.
- 2026-05-29: karmadactl reference documentation listed commands for cluster federation control, including init, join, register, apply, promote, and top.

### Related projects

- Kubernetes is the API and workload model Karmada extends across clusters.
- kubectl is the command-style reference point for karmadactl.
- Flux and Helm appear in Karmada ecosystem workflows for multi-cluster GitOps and package rollout.

### Sources

- <https://github.com/karmada-io/karmada>
- <https://karmada.io/>
- <https://karmada.io/docs/reference/karmadactl/karmadactl-commands/karmadactl/>
- <https://karmada.io/docs/releases/>
- <https://www.cncf.io/projects/karmada/>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Combined YAML source

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


## Sources

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