# Install sonobuoy with Homebrew, Nix, zypper

Kubernetes component that generates reports on cluster conformance. Version 0.57.5 via Homebrew; verified 2026-07-26. Also installable with nix: nix profile install nixpkgs#sonobuoy.

## Install

```sh
sudo av install brew:sonobuoy
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install sonobuoy
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#sonobuoy
```

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

- zypper (92%):

```sh
sudo zypper install sonobuoy
```

  Evidence: openSUSE Tumbleweed package metadata: sonobuoy from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

## Package facts

- **Package key:** brew:sonobuoy
- **Package manager:** Homebrew
- **Version:** 0.57.5
- **Source summary:** Kubernetes component that generates reports on cluster conformance
- **Homepage:** <https://sonobuoy.io/>
- **Repository:** <https://github.com/vmware-tanzu/sonobuoy>
- **Last updated:** 2026-07-26T04:03:43+02:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- sonobuoy (alias)

## Install behavior

- Bottle: not available

## Freshness

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

Sonobuoy is a Kubernetes diagnostics and conformance tool. It runs plugins, including Kubernetes end-to-end conformance tests, and packages the results into reports that cluster operators can retrieve and inspect from the command line.

### Project history

The public GitHub repository was created in July 2017 and is maintained under the VMware Tanzu organization. The repository and documentation describe Sonobuoy as a cluster-agnostic, extensible way to run diagnostic plugins and gather Kubernetes resource and node data.

Sonobuoy's documented release model changed at v0.20: the project decoupled its releases from Kubernetes releases while continuing to track functional compatibility across Kubernetes versions. That matters for operators because the CLI can be updated on its own cadence while still running conformance workflows against supported clusters.

### Adoption history

Sonobuoy became part of the practical Kubernetes certification and troubleshooting toolkit because its default workflow runs Kubernetes conformance tests and produces artifacts that can be checked with `sonobuoy results`. The official docs also document Homebrew installation and direct binary downloads.

The package-manager metadata in this batch shows Sonobuoy packaged by Homebrew, Nix, and openSUSE. Its audience is narrower than everyday developer CLIs, but important in Kubernetes infrastructure circles where conformance and repeatable cluster diagnostics are routine.

### How it is used

A common Sonobuoy session is `sonobuoy run --wait`, then `sonobuoy retrieve`, then `sonobuoy results` on the returned archive. Advanced users add custom plugins, registry overrides, private image handling, or alternate e2e test selections.

The tool expects an administrator's Kubernetes context through `kubeconfig` and `KUBECONFIG`, but it does not define a standalone Sonobuoy credentials file. Its configuration is mostly command-line and Kubernetes-resource driven.

### Why package nerds care

For package people, Sonobuoy is a good example of cloud-native tooling becoming a normal local executable: it is installed with `brew install sonobuoy`, talks to a cluster through kubeconfig, creates temporary in-cluster resources, and leaves behind a results archive.

It also represents the Kubernetes ecosystem's preference for composable CLIs around declarative infrastructure: package the runner locally, execute work in the cluster, retrieve machine-readable artifacts, and make conformance auditable.

### Timeline

- 2017: Public GitHub repository created.
- 2020: v0.20 release line documented a release cadence independent from Kubernetes releases.
- 2026: v0.57.5 released on GitHub.

### Related projects

- Kubernetes is the target platform and source of the e2e conformance tests Sonobuoy runs.
- KinD is documented as a suggested local cluster option for getting started.
- kubectl remains the adjacent CLI used for Kubernetes access and some advanced workflows.

### Sources

- <https://api.github.com/repos/vmware-tanzu/sonobuoy>
- <https://api.github.com/repos/vmware-tanzu/sonobuoy/releases>
- <https://github.com/vmware-tanzu/sonobuoy>
- <https://sonobuoy.io/docs/v0.57.5/>
- input.json source_facts.package-manager


## Security Notes

infrastructure mutation or orchestration signal.

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

## Other Package-Manager Records

- Nix - sonobuoy: normalized package name match | nixpkgs package indexes: pkgs/by-name/so/sonobuoy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- zypper - sonobuoy - 0.57.5-1.3: normalized package name match | openSUSE Tumbleweed package metadata: sonobuoy from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Conformance test suite for diagnosing a Kubernetes cluster | https://github.com/vmware-tanzu/sonobuoy
- zypper - sonobuoy-bash-completion - 0.57.5-1.3: normalized package name match | openSUSE Tumbleweed package metadata: sonobuoy-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Bash Completion for sonobuoy | https://github.com/vmware-tanzu/sonobuoy
- zypper - sonobuoy-fish-completion - 0.57.5-1.3: normalized package name match | openSUSE Tumbleweed package metadata: sonobuoy-fish-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Fish Completion for sonobuoy | https://github.com/vmware-tanzu/sonobuoy
- zypper - sonobuoy-zsh-completion - 0.57.5-1.3: normalized package name match | openSUSE Tumbleweed package metadata: sonobuoy-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Zsh Completion for sonobuoy | https://github.com/vmware-tanzu/sonobuoy


## Combined YAML source

View the package source record on GitHub. [combined/sonobuoy.yml](https://github.com/mxcl/pkgdb/blob/main/combined/sonobuoy.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
