Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

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

KubeLinter

Free

Free plan

Getting started

  1. Open the KubeLinter documentation website
  2. Install with Go, a release binary, Homebrew or LinuxBrew, nix-shell, or Docker
  3. Provide Kubernetes YAML files, Helm chart directories, or Kustomize directories
  4. Enable or disable checks and define YAML or CEL policies
  5. Run KubeLinter and select plain text, JSON, or SARIF output
  6. 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.