basetenlabs/buildkit

basetenlabs/buildkit

Description: concurrent, cache-efficient, and Dockerfile-agnostic builder toolkit

Language: Go

License: Apache-2.0

Stars: 0

Forks: 0

Open issues: 13

Created: 2026-04-09T01:42:55Z

Pushed: 2026-06-11T00:05:19Z

Default branch: v0.22-base

Fork: yes

Parent repository: moby/buildkit

Archived: no

README: 

BuildKit


BuildKit is a toolkit for converting source code to build artifacts in an efficient, expressive and repeatable manner.

Key features:

• Automatic garbage collection
• Extendable frontend formats
• Concurrent dependency resolution
• Efficient instruction caching
• Build cache import/export
• Nested build job invocations
• Distributable workers
• Multiple output formats
• Pluggable architecture
• Execution without root privileges

Read the proposal from https://github.com/moby/moby/issues/32925

Introductory blog post https://blog.mobyproject.org/introducing-buildkit-17e056cc5317

Join #buildkit channel on Docker Community Slack

> [!NOTE] > If you are visiting this repo for the usage of BuildKit-only Dockerfile features > like RUN --mount=type=(bind|cache|tmpfs|secret|ssh), please refer to the > Dockerfile reference.

> [!NOTE] > docker build uses Buildx and BuildKit by default since Docker Engine 23.0. > You don't need to read this document unless you want to use the full-featured > standalone version of BuildKit.

• [Used by](#used-by)
• [Quick start](#quick-start)
• [Linux Setup](#linux-setup)
• [Windows Setup](#windows-setup)
• [macOS Setup](#macos-setup)
• [Build from source](#build-from-source)
• [Exploring LLB](#exploring-llb)
• [Exploring Dockerfiles](#exploring-dockerfiles)
• [Building a Dockerfile with buildctl](#building-a-dockerfile-with-buildctl)
• [Building a Dockerfile using external frontend](#building-a-dockerfile-using-external-frontend)
• [Output](#output)
• [Image/Registry](#imageregistry)
• [Local directory](#local-directory)
• [Docker tarball](#docker-tarball)
• [OCI tarball](#oci-tarball)
• [containerd image store](#containerd-image-store)
• [Cache](#cache)
• [Garbage collection](#garbage-collection)
• [Export cache](#export-cache)
• [Inline (push image and cache together)](#inline-push-image-and-cache-together)
• [Registry (push image and cache separately)](#registry-push-image-and-cache-separately)
• [Local directory](#local-directory-1)
• [GitHub Actions cache (experimental)](#github-actions-cache-experimental)
• [S3 cache (experimental)](#s3-cache-experimental)
• [Azure Blob Storage cache (experimental)](#azure-blob-storage-cache-experimental)
• [Consistent hashing](#consistent-hashing)
• [Metadata](#metadata)
• [Systemd socket activation](#systemd-socket-activation)
• [Expose BuildKit as a TCP service](#expose-buildkit-as-a-tcp-service)
• [Load balancing](#load-balancing)
• [Containerizing BuildKit](#containerizing-buildkit)
• [Podman](#podman)
• [Nerdctl](#nerdctl)
• [Kubernetes](#kubernetes)
• [Daemonless](#daemonless)
• [OpenTelemetry support](#opentelemetry-support)
• [Running BuildKit without root privileges](#running-buildkit-without-root-privileges)
• [Building multi-platform images](#building-multi-platform-images)
• [Configuring buildctl](#configuring-buildctl)
• [Color Output Controls](#color-output-controls)
• [Number of log lines (for active steps in tty mode)](#number-of-log-lines-for-active-steps-in-tty-mode)
• [Contributing](#contributing)

Used by

BuildKit is used by the following projects:

• Moby & Docker (DOCKER_BUILDKIT=1 docker build)
• img
• OpenFaaS Cloud
• container build interface
• Tekton Pipelines (formerly Knative Build Templates)
• the Sanic build tool
• vab
• Rio
• kim
• PouchContainer
• Docker buildx
• Okteto Cloud
• Earthly earthfiles
• Gitpod
• Dagger
• envd
• Depot
• Namespace
• Unikraft
• DevZero
• dacc

Quick start

:information_source: For Kubernetes deployments, see [examples/kubernetes](./examples/kubernetes).

BuildKit is composed of the buildkitd daemon and the buildctl client. While the buildctl client is available for Linux, macOS, and Windows, the buildkitd daemon is only available for Linux and *Windows currently.

The latest binaries of BuildKit are available here for Linux, macOS, and Windows.

Linux Setup

The buildkitd daemon requires the following components to be installed:

• runc or crun
• containerd (if you want to use containerd worker)

Starting the `buildkitd` daemon: You need to run buildkitd as the root user on the host.

$ sudo buildkitd

To run buildkitd as a non-root user, see [docs/rootless.md](docs/rootless.md).

The buildkitd daemon supports two worker backends: OCI (runc) and containerd.

By default, the OCI (runc) worker is used. You can set --oci-worker=false --containerd-worker=true to use the containerd worker.

We are open to adding more backends.

To start the buildkitd daemon using systemd socket activation, you can install the buildkit systemd unit files. See [Systemd socket activation](#systemd-socket-activation)

The buildkitd daemon listens gRPC API on /run/buildkit/buildkitd.sock by default, but you can also use TCP sockets. See…