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

ko

ko.build

  • Free plan
  • Windows
  • macOS
  • Linux
7.7 Club score Visit ko.build

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.

ko

Free

Open source

Getting started

  1. Open the ko website and installation guide
  2. Install ko on Linux, macOS, or Windows using a documented release, package manager, or source option
  3. Configure a container registry and credentials from Docker configuration or supported environment credentials
  4. Build a Go application with ko using the configured base image
  5. 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.