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

kubeconform

kubeconform.mandragor.org

  • Free plan
  • Windows
  • macOS
  • Linux
  • Self-hosted

What kubeconform is

Kubeconform is a free command-line tool for checking Kubernetes manifests before deployment. It validates files against Kubernetes OpenAPI specifications and can process validations and schema downloads concurrently, while caching downloaded files in memory. By default, it uses a self-updating fork of the Kubernetes JSON schema registry for recent Kubernetes versions. For custom resources, users can configure local or remote schema locations, including local schemas for offline validation. Results can be produced as JSON, JUnit, TAP, or text. Documentation covers using Kubeconform with GitHub Actions and GitLab CI through Docker images published to GitHub Container Registry. Installation instructions cover Linux, macOS via Homebrew, and Windows downloads. The project is licensed under Apache-2.0, and no paid plans or usage limits are stated. Its checks cover Kubernetes OpenAPI specifications, so additional server-side validations are outside its scope. The Go module interface is described as work in progress and is not yet stable. The GitHub Actions documentation notes that registry bandwidth was free during its beta and might cost money afterward.

Who it suits

Kubeconform suits people who want a command-line check of Kubernetes manifests before deployment, including CI workflows. It may also suit users validating custom resources with configured local or remote schemas.

Good to know, and what to watch

  • Free, with no usage limits stated.
  • Supports JSON, JUnit, TAP, and text output.
  • Custom schema locations support custom resources.
  • Local schemas allow offline validation.
  • Installation instructions cover Linux, macOS, and Windows.
  • Checks do not include additional server-side validations.
  • The Go module interface is not yet stable.
  • Registry bandwidth could incur costs after its beta.

Kubeconform

Free

Free plan

Getting started

  1. Open the Kubeconform website
  2. Install it using the documented Linux method
  3. On macOS, install through Homebrew
  4. On Windows, use the documented downloads
  5. Run the command-line validator against Kubernetes manifests
  6. Configure local or remote schema locations for custom resources
  7. Use Docker images from GitHub Container Registry in CI workflows

Limits to check

The Kubeconform plan is free at no cost, with no usage limits stated. Validation is limited to Kubernetes OpenAPI specifications and does not include additional server-side checks.

The Club's review

Kubeconform is a free command-line validator for Kubernetes manifests, best suited to developers and operations teams who want schema checks in local workflows or CI. It is a focused, practical pre-deployment check, but not a substitute for server-side validation or broader policy review.

Overview

Kubeconform checks manifests against Kubernetes OpenAPI specifications, helping catch configuration errors before deployment. Its local execution model suits scripted checks without a hosted service in the workflow. That narrow scope is also its chief boundary: it does not assess configuration compliance, deployed systems, or policy as code, and it cannot cover additional server-side validations.

By default, the tool uses a self-updating fork of the Kubernetes JSON schema registry, with schemas for recent Kubernetes versions. Teams can configure remote or local schema locations for custom resources; local schemas also enable offline validation. This flexibility helps when manifests include resources beyond the standard Kubernetes types, but users need to point Kubeconform to the schemas those resources require.

Key features

Validation and output

Kubeconform validates manifests and downloads schemas concurrently, then caches downloaded files in memory. That design makes it suitable for repeatable checks where schema retrieval and validation are part of the same workflow. Its command line emits JSON, JUnit, TAP, or text, giving teams a choice of formats for review or automation.

CI and integrations

The documentation shows Kubeconform used with GitHub Actions and GitLab CI through Docker images, which makes it straightforward to place a manifest check in an existing pipeline. Docker images are published to GitHub Container Registry. GitHub Action documentation notes that registry bandwidth was free during beta and could incur costs afterward, so teams relying on those images should account for that caveat.

The installation guide covers Linux, macOS through Homebrew, and Windows downloads. The project is licensed under Apache-2.0. A Go module interface exists as work in progress, but its unstable status makes it a poor foundation for applications that need a dependable library API today.

Pricing

Kubeconform costs free, with no paid plans or usage limits stated on the official site. That makes it a low-friction choice for individual use and CI checks without a software subscription. The main cost caveat is operational rather than a license fee: GitHub Container Registry bandwidth for the GitHub Action may incur charges after its beta period.

Platforms

Kubeconform supports Linux, macOS, and Windows, and is self-hosted. The documented installation paths cover all three desktop and server operating systems, while its local execution model suits development machines and build environments alike.

Who it's for

Kubeconform is a good fit for teams that want a focused check that Kubernetes manifests conform to OpenAPI schemas before they reach deployment. Custom schema locations make it useful where custom resources are part of the workflow, and local schemas allow validation without a network connection. It is less suitable as the only safeguard for teams that need policy enforcement, compliance checks, or validation beyond what the API specifications express.

Pros and cons

  • Free with no stated usage limits: teams can add manifest checks without a subscription or published quota.
  • Flexible schema sources: remote and local schemas support custom resources, including offline validation.
  • Pipeline-friendly outputs: JSON, JUnit, TAP, and text formats suit both automation and direct inspection.
  • Focused coverage: OpenAPI checks catch schema mismatches but do not extend to additional server-side validation or broader compliance and policy testing.
  • Unstable Go interface: the module API is still in progress, limiting its suitability for software built around a stable library.
  • Potential registry costs: GitHub Container Registry bandwidth may no longer be free after beta.

Alternatives

For a broader infrastructure testing shortlist, see Infrastructure Testing Tools. Chef InSpec is worth considering for readers seeking a freemium option with a free plan limited to non-production workloads and personal, non-commercial use, plus a 30-day trial. Conftest is another free, Apache 2.0-licensed option for teams comparing infrastructure testing tools.

Test Kitchen may suit readers who want a free, Apache 2.0-licensed tool distributed through RubyGems, system packages, or Cinc/Chef Workstation. For another free Kubernetes-focused option, kube-score is MIT-licensed and available across Linux, macOS, self-hosted environments, web, and Windows. Terratest is a free, Apache 2.0-licensed project identified as built by Gruntwork.

CloudSploit offers a free self-hosted open-source version alongside a hosted commercial version with custom pricing. Readers working with CloudFormation can compare AWS CloudFormation, whose service is free while underlying AWS resources are billed at their own rates. cfn-lint is a free, MIT-0-licensed alternative with Python 3.10–3.14 support.

Verdict

Choose Kubeconform if you need a free, local and scriptable way to check Kubernetes manifests against schemas, especially in CI or when custom and offline schema sources matter. Look elsewhere if your requirement is server-side validation, policy enforcement, compliance analysis, or a stable Go library interface; Kubeconform deliberately does not cover those needs.

The verdict

Kubeconform provides specification-based checks for Kubernetes manifests, with configurable schemas and several output formats. Its scope does not extend to additional server-side validation, and the Go module interface remains in progress.

Questions people ask

How much does Kubeconform cost?

The listed Kubeconform plan is free. It is provided as a free plan with no paid plans stated.

Which platforms can run Kubeconform?

Kubeconform supports Linux, macOS, Windows, and self-hosted environments.

Can it validate custom resources offline?

Yes. You can configure local or remote schema locations for custom resources, and local schemas support offline validation.

What output formats are available?

The command line can produce JSON, JUnit, TAP, and text output.

Can Kubeconform run in CI systems?

Documentation shows GitHub Actions and GitLab CI usage through Docker images published to GitHub Container Registry.

What license does it use?

The GitHub repository identifies Kubeconform's license as Apache-2.0.

What the maker publishes

CI integrations
The documentation shows using Kubeconform with GitHub Actions and GitLab CI through its Docker images. source
Custom resources
Users can configure remote or local schema locations to validate custom resources and support offline validation. source
Docker registry
Kubeconform publishes Docker images to GitHub Container Registry for use in CI workflows. source
Installation
The official installation guide documents Linux, macOS via Homebrew, and Windows downloads. source
Library status
The Go module interface is described as work in progress and not yet stable. source
License
The GitHub repository identifies the project license as Apache-2.0. source
Output formats
The command line supports JSON, JUnit, TAP, and text output formats. source
Performance
It validates and downloads manifests concurrently and caches downloaded files in memory. source
Pricing caveat
The GitHub Action documentation says GitHub Container Registry bandwidth was free during its beta and might incur costs afterward. source
Purpose
Kubeconform validates Kubernetes manifests so users can catch broken configuration before deploying. source
Schemas
It uses a self-updating fork of the Kubernetes JSON schema registry by default to provide schemas for recent Kubernetes versions. source
Validation limit
Kubeconform checks manifests against Kubernetes OpenAPI specifications, so additional server-side validations are outside its coverage. source

Checked against the maker's pages on 4 Oct 2026.