ko
ko.build
- Free plan
- Windows
- macOS
- Linux
What ko is
ko is an open-source builder for container images of Go applications. It runs go build on the local machine, so Docker does not need to be installed. It is intended for a single Go application with few dependencies on the operating system base image, such as an application without cgo or OS package requirements. Builds can target all platforms supported by the configured base image or selected platforms such as linux/amd64 and linux/arm64. For Kubernetes workflows, ko resolve builds images for ko:// references in YAML and replaces those references with image references; ko apply can apply the resolved configuration. ko reuses the normal Go build cache and avoids pushing image blobs already present in the remote registry. It generates and uploads SPDX-format SBOMs by default, with an option to disable that. Registry credentials can come from Docker configuration, with built-in environment credential support for Google, Amazon, Azure and GitHub registries. A Terraform provider supports Infrastructure-as-Code workflows. ko supports Go only, defaults to CGO_ENABLED=0, and requires OS packages to be available in the configured base image.
Who it suits
ko suits developers building container images for Go applications, especially those with few dependencies on the base image. Its Kubernetes and Terraform integrations may also suit teams using those workflows.
Good to know, and what to watch
- Builds images without requiring Docker.
- Supports selected multi-platform build targets.
- Generates and uploads SPDX-format SBOMs by default.
- Reuses the standard Go build cache.
- Can replace ko:// references in Kubernetes YAML.
- Supports Go applications only.
- Defaults to CGO_ENABLED=0.
- OS packages must be available in the configured base image.
- Windows container image support is experimental and requires a Windows base image.
Plans
Every plan and priceko
Open source
Getting started
- Open the ko website and installation guide
- Install ko on Linux, macOS, or Windows using a documented release, package manager, or source option
- Configure a container registry and credentials from Docker configuration or supported environment credentials
- Build a Go application with ko using the configured base image
- Use ko resolve or ko apply with Kubernetes YAML when needed
Limits to check
ko supports Go applications only, uses CGO_ENABLED=0 by default, and requires needed OS packages to be present in the configured base image.
The verdict
ko provides a focused image-building workflow for Go, with Kubernetes support and default SBOM generation. Check its Go-only scope and base-image requirements against your application before adopting it.
Questions people ask
Is ko free?
Yes. ko is free and open source, with a listed plan price of free.
Which platforms does ko support?
ko is available on Linux, macOS, and Windows. Windows container image support is described as experimental and requires a Windows base image.
Does ko require Docker?
No. ko runs `go build` locally and does not require Docker to be installed.
Can ko build for multiple architectures?
Yes. It can build for all platforms supported by the configured base image or selected platforms such as linux/amd64 and linux/arm64.
Does ko generate SBOMs?
Yes. ko generates and uploads an SPDX-format SBOM for every image by default, and generation can be disabled with `--sbom=none`.
What the maker publishes
- Best fit
- ko is ideal for a single Go application with few or no dependencies on the operating system base image, such as applications without cgo or OS package dependencies. source
- Build cache
- ko reuses the normal go build cache and avoids pushing image blobs already present in the remote registry. source
- Build method
- ko runs go build on the local machine and does not require Docker to be installed. source
- Community support
- The project offers a bi-weekly community meeting and discussion in the #ko-build channel on Kubernetes Slack. source
- Debugging
- The --debug build flag adds Delve and debug symbols to the image and runs the app in debug mode on port 40000; the feature is intended for development, not production. source
- How it builds
- ko runs go build on the local machine and does not require Docker to be installed. source
- Ideal use
- ko is ideal for Go applications without many dependencies on the operating system base image, such as applications that do not use cgo or require OS packages. source
- Install platforms
- The installation guide documents Windows, macOS, and Linux installation options, including GitHub releases, package managers, and source installation. source
- Integrations
- ko provides a Terraform provider for using image builds in Infrastructure-as-Code workflows. source
- Kubernetes
- ko resolve replaces ko:// Go import paths in Kubernetes YAML with built image references, and ko apply can apply the resolved configuration. source
- Kubernetes workflow
- ko resolve builds images for ko:// references in Kubernetes YAML and replaces them with the resulting image references. source
- Limit
- ko only supports Go applications and works best when applications do not depend on the underlying image; builds use CGO_ENABLED=0 by default. source
- Limitations
- ko supports Go applications only, defaults to CGO_ENABLED=0, and requires OS packages to be available in the configured base image. source
- Multi-platform builds
- ko can build for all platforms supported by the configured base image or for selected platforms such as linux/amd64 and linux/arm64. source
- Project and community
- ko is a Cloud Native Computing Foundation Sandbox project, and its community page lists bi-weekly meetings and a Kubernetes Slack channel. source
- Project status
- ko is a Cloud Native Computing Foundation Sandbox project. source
- Purpose
- ko is a simple, fast container image builder for Go applications. source
- Registry authentication
- ko supports registry credentials from Docker configuration and has built-in environment credential support for Google, Amazon, Azure, and GitHub container registries. source
- Release verification
- The installation guide describes verifying releases with GitHub Artifact attestations and says releases through v0.19.1 used SLSA provenance. source
- SBOMs
- Since v0.9, ko generates and uploads an SPDX-format SBOM for every image by default; SBOM generation can be disabled with --sbom=none. source
- Static assets
- ko bundles contents of an application's kodata directory into its image and exposes the image path through KO_DATA_PATH. source
- Tool integrations
- The FAQ lists integrations or support in Skaffold, goreleaser, Tekton, Carvel kbld, and Tilt. source
- Windows image support
- Windows container image support is described as new, experimental, and tenuous, and requires configuring a Windows base image. source
Checked against the maker's pages on 5 Oct 2026.