# Install kubergrunt with Homebrew, MacPorts, Nix

Collection of commands to fill in the gaps between Terraform, Helm, and Kubectl. Version 0.19.0 via Homebrew; verified 2026-07-27. Also installable with nix: nix profile install nixpkgs#kubergrunt.

## Install

```sh
sudo av install brew:kubergrunt
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install kubergrunt
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install kubergrunt
```

  Evidence: MacPorts ports tree: sysutils/kubergrunt/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#kubergrunt
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ku/kubergrunt/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:kubergrunt
- **Package manager:** Homebrew
- **Version:** 0.19.0
- **Source summary:** Collection of commands to fill in the gaps between Terraform, Helm, and Kubectl
- **Homepage:** <https://github.com/gruntwork-io/kubergrunt>
- **Repository:** <https://github.com/gruntwork-io/kubergrunt>
- **Last updated:** 2026-07-27T21:58:46+02:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- kubergrunt (alias)

## Install behavior

- Bottle: not available

## Freshness

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

kubergrunt is Gruntwork's standalone Go CLI for operational gaps between Terraform, Helm, and kubectl. It grew around the practical chores of running Kubernetes infrastructure as code, especially EKS authentication, Helm/Tiller-era certificate handling, and helper commands that did not fit cleanly into Terraform modules or kubectl alone.

### Project history

The repository describes kubergrunt as a collection of commands for managing Kubernetes clusters where Terraform, Helm, and kubectl leave small operational gaps. Early release notes show v0.1.x commands for EKS configuration and token workflows, followed by Helm deployment, TLS, grant, configure, and revoke functionality.

### Adoption history

The tool's audience has primarily been Gruntwork users and teams consuming Gruntwork's Kubernetes infrastructure modules. Its package-manager presence matters because it lets module users install the matching helper binary through Homebrew, MacPorts, or Nix rather than treating it as an internal script.

### How it is used

Common usage is task-oriented: configure kubectl for an EKS cluster, generate authentication material, manage Helm-related TLS certificates, and run helper commands around cluster bootstrap. The README also points users to release binaries and the Gruntwork installer, reflecting its role as a companion binary to published infrastructure modules.

### Why package nerds care

kubergrunt is a classic package-nerd artifact: a small CLI born from glue code that proved useful enough to version, release, and package. It documents a period when production Kubernetes automation often required stitching Terraform, kubectl, Helm, and cloud-provider authentication together with dedicated helper binaries.

### Timeline

- Initial v0.1.x releases: kubergrunt shipped EKS-related commands such as configure, token, and deploy.
- v0.1.5: The project added Helm deploy, undeploy, configure, and grant commands.
- v0.2.0: helm deploy began requiring an RBAC entity so the local Helm client could work immediately after deployment.
- v0.3.0: helm deploy bug fixes changed client certificate parameters and custom Helm home behavior.

### Related projects

- kubergrunt is closely related to Terraform, Terragrunt, Gruntwork Kubernetes modules, AWS EKS, Helm, kubectl, and Kubernetes Secrets used for TLS material.

### Sources

- <https://docs.gruntwork.io/discussions/knowledge-base/684/>
- <https://github.com/gruntwork-io/kubergrunt>
- <https://github.com/gruntwork-io/kubergrunt/blob/master/README.md>
- <https://github.com/gruntwork-io/kubergrunt/releases>


## Security Notes

narrow executable package without higher-risk signals.

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

## Other Package-Manager Records

- Nix - kubergrunt: normalized package name match | nixpkgs package indexes: pkgs/by-name/ku/kubergrunt/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- MacPorts - kubergrunt: normalized package name match | MacPorts ports tree: sysutils/kubergrunt/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Combined YAML source

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


## Sources

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