KubeLinter
docs.kubelinter.io
- Free plan
- macOS
- Linux
- Self-hosted
What KubeLinter is
KubeLinter is a free static analyzer for Kubernetes configuration, checking YAML files, Helm charts, and Kustomize directories for best practices, production readiness, and security. Its default checks cover concerns such as whether containers run as non-root, least privilege is enforced, and sensitive information is stored only in secrets. Users can enable or disable checks and create custom ones to reflect organizational policies, using YAML configuration and CEL expressions. When a check fails, KubeLinter provides remediation recommendations and returns a non-zero exit code, making findings usable in automated workflows. Reports can be produced in plain text, JSON, or SARIF, including multiple formats in one run. The project documents integrations with pre-commit hooks, a Docker-based pre-commit hook, and a GitHub Action for CI. Installation methods include Go, release binaries, Homebrew or LinuxBrew, nix-shell, and Docker. Container images are cosign-signed, with a public key for verification. KubeLinter is licensed under Apache License 2.0; its repository says StackRox created the project and Red Hat now powers it. The project notes that command usage, flags, and configuration file formats may change in the future.
Who it suits
KubeLinter suits teams checking Kubernetes YAML, Helm, or Kustomize configurations against security and operational policies. It can fit CI workflows that use pre-commit hooks or GitHub Actions.
Good to know, and what to watch
- Checks Kubernetes YAML, Helm, and Kustomize
- Supports custom checks with YAML and CEL
- Reports remediation recommendations when checks fail
- Outputs plain text, JSON, or SARIF
- Command usage and flags may change
- Configuration file formats may change
Plans
Every plan and priceKubeLinter
Free plan
Getting started
- Open the KubeLinter documentation website
- Install with Go, a release binary, Homebrew or LinuxBrew, nix-shell, or Docker
- Provide Kubernetes YAML files, Helm chart directories, or Kustomize directories
- Enable or disable checks and define YAML or CEL policies
- Run KubeLinter and select plain text, JSON, or SARIF output
- Add a pre-commit hook or GitHub Action for CI
Limits to check
The project warns that command usage, flags, and configuration file formats may change in the future.
The verdict
KubeLinter offers configurable checks and machine-readable reports for Kubernetes configuration, with documented CI integrations. Teams should allow for possible changes to commands, flags, and configuration formats.
Questions people ask
How much does KubeLinter cost?
KubeLinter is free under the Apache License 2.0.
Which platforms can run it?
It supports Linux, macOS, and self-hosted use.
What configuration formats can it analyze?
It lints Kubernetes YAML files, Helm chart directories, and Kustomize directories.
Can policies be customized?
Yes. Checks can be enabled or disabled, and custom checks can be created with YAML configuration and CEL expressions.
Which report formats are available?
KubeLinter supports plain text, JSON, and SARIF, including multiple formats in one run.
Who powers the project?
The repository says StackRox created KubeLinter and Red Hat now powers it.
What the maker publishes
- Custom policies
- Users can enable or disable checks and create custom checks to match organizational policies. source
- Default checks
- Its default checks cover issues such as running containers as non-root, enforcing least privilege, and storing sensitive information only in secrets. source
- Findings
- When a lint check fails, KubeLinter reports remediation recommendations and returns a non-zero exit code. source
- Image verification
- KubeLinter container images are signed with cosign, and the project provides a public key for verification. source
- Input types
- KubeLinter can lint Kubernetes YAML files, Helm chart directories, and Kustomize directories. source
- Installation
- The project documents installation using Go, release binaries, Homebrew or LinuxBrew, nix-shell, and Docker. source
- Integrations
- The project documents use with pre-commit hooks, a Docker-based pre-commit hook, and a GitHub Action for CI. source
- License
- KubeLinter is licensed under the Apache License 2.0. source
- Maker
- The repository says KubeLinter was created by StackRox and is now powered by Red Hat. source
- Notable limitation
- The project notes that command usage, flags, and configuration file formats may change in the future. source
- Report formats
- It supports plain text, JSON, and SARIF output, including writing multiple formats in one run. source
- Security reporting
- The security policy directs people reporting vulnerabilities to Red Hat's Product Security team for confidential disclosure. source
- Support and community
- The project points users to its Slack workspace to engage with maintainers and other users. source
- What it does
- KubeLinter statically analyzes Kubernetes YAML, Helm charts, and Kustomize manifests for best practices, production readiness, and security. source
Checked against the maker's pages on 5 Oct 2026.