Sonobuoy
sonobuoy.io
- Free plan
- Windows
- macOS
- Linux
- Self-hosted
What Sonobuoy is
Sonobuoy is free, open-source software for examining Kubernetes cluster state with non-destructive configuration tests. It checks conformance with official Kubernetes specifications and creates diagnostics for troublesome workloads. Teams can write plugins for additional tests and data collection. Built-in plugins run Kubernetes end-to-end tests and gather systemd host logs, while listed community plugins cover CIS Benchmarks, RBAC permissions, cluster inventory, reliability, and security visibility. Sonobuoy is cluster agnostic and officially supports the latest three minor Kubernetes versions; version 0.20 and later supports Kubernetes 1.17 or later. It can run end-to-end tests with custom registries in air-gapped deployments. Running it requires an active Kubernetes cluster and an admin kubeconfig. Installation is available through binary releases or Homebrew on macOS. Sonobuoy runs locally on Linux, macOS, Windows, or self-hosted systems, with AWS and Google Cloud Platform support.
Who it suits
Sonobuoy suits Kubernetes administrators and teams needing conformance checks, workload diagnostics, or custom cluster tests. It requires an active cluster and admin kubeconfig, and its defaults need explicit security hardening.
Good to know, and what to watch
- Free and open source
- Checks official Kubernetes conformance
- Supports custom plugins and data collection
- Works in air-gapped deployments
- Includes end-to-end and systemd-log plugins
- Requires an active cluster and admin kubeconfig
- Defaults are not secure by default
- Docker Desktop logging commands may fail
- Docker is required for the images subcommand
The verdict
Sonobuoy combines Kubernetes conformance testing, diagnostics, and extensible plugins in a free tool. Plan for administrator access and hardening, and note the documented Docker Desktop limitations.
What the maker publishes
- Air-gapped operation
- It supports end-to-end testing with custom registries in air-gapped deployments. source
- Air-gapped use
- It supports end-to-end tests with custom registries in air-gapped deployments. source
- Built-in plugins
- The default plugins are Kubernetes end-to-end tests and systemd log gathering. source
- CIS benchmarks
- The CIS Benchmarks plugin uses kube-bench and runs checks on master and worker nodes. source
- Cluster support
- Sonobuoy is cluster agnostic and officially supports the latest three minor Kubernetes versions. source
- Cluster support
- Sonobuoy runs on any Kubernetes cluster and officially supports the latest three Kubernetes minor versions. source
- Community plugins
- Listed plugins include CIS Benchmarks, Kube-hunter, Who-can, Cluster-Inventory, and Reliability Scanner. source
- Community support
- Community support is provided through the Sonobuoy GitHub project, including GitHub issues. source
- Conformance testing
- It tests whether a cluster conforms to official Kubernetes specifications. source
- Conformance testing
- It tests whether a cluster conforms to official Kubernetes specifications. source
- Custom testing
- Users can create plugins for custom configuration tests and data collection. source
- Custom testing
- Users can create plugins to test custom configurations or use community plugins. source
- Docker dependency
- The sonobuoy images subcommand requires Docker to be installed. source
- Docker Desktop limitation
- The documentation reports that kubectl logs, sonobuoy logs, and sonobuoy retrieve may fail and the systemd-logs plugin may hang on Docker Desktop Kubernetes. source
- End-to-end tests
- The end-to-end plugin runs tests maintained by the upstream Kubernetes community. source
- Host logs
- The systemd-logs plugin gathers host log information by chrooting into the node filesystem and running journalctl. source
- Installation
- Installation is available through binary releases or Homebrew on macOS. source
- Integrations
- The documentation references AWS Quickstart, KinD, kubectl, Docker, and Docker Hub workflows. source
- Kubernetes versions
- Starting with version 0.20, Sonobuoy supports Kubernetes 1.17 or later. source
- Open source
- Sonobuoy is released as open source software. source
- Prerequisites
- Running Sonobuoy requires an active Kubernetes cluster and an admin kubeconfig. source
- Prerequisites
- Running Sonobuoy requires access to an up-and-running Kubernetes cluster and an admin kubeconfig. source
- Purpose
- Sonobuoy is a diagnostic tool for understanding Kubernetes cluster state through accessible, non-destructive configuration tests. source
- Purpose
- Sonobuoy is a diagnostic tool for understanding Kubernetes cluster state by running configuration tests in an accessible, non-destructive way. source
Checked against the maker's pages on 1 Oct 2026.