Sign inSign up

sbx/kit-builder

Verified Publisher

By Docker, Inc

•Updated about 16 hours ago

DHI workload with Docker Engine, Buildx, and QEMU for building kits across architectures.

Sandbox Kit
0

2.1K

sbx/kit-builder repository overview

Digest

sha256:796c30d8f822…

Size

125.9 MB

Schema

v3

Pushed

about 16 hours ago

Specificationspec.yaml

WORKLOAD

DHI workload with Docker Engine, Buildx, and QEMU for building kits across architectures.


Arguments
NameRequiredDefaultDescription
buildkitExposeOptionalfalse

Let BuildKit listen on TCP for the host's remote driver (unauthenticated root build API)

Options: false, true
buildkitPortOptional3330

In-container TCP port BuildKit listens on when buildkitExpose is true

versionRequired—

Kit Builder policy revision


Provides[email protected], deb/[email protected], deb/[email protected], deb/ca-certificates@20250419, deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/tzdata@2026, deb/[email protected], deb/[email protected]

CapabilitiesExpand a row to see its full configuration. See the full spec for the complete descriptor.
TypeRequiredDescription
com.docker.sandbox/dockerd@1RequiredBuilds kit images with Docker-in-Docker
com.docker.sandbox/long-running@1RequiredKeep the builder available between build clients
com.docker.sandbox/kit-registry@1RequiredPush built kit images into the runtime's image store
com.docker.sandbox/port@1Required—
com.docker.sandbox/resources@1Required—
com.docker.sandbox/network-policy@1Required—
com.docker.sandbox/lifecycle@1Required—
com.docker.sandbox/agent-context@1Optional—
com.docker.sandbox/agent-context@2Optional—

Run in a sandbox

sbx run sbx/kit-builder:latest

Make sure you have docker sbx installed

Run the following command to install sbx on your machine.

macOS
brew install docker/tap/sbx
Windows
winget install Docker.sbx
Learn more about docker sbx⁠

⁠Kit Builder for Docker Sandboxes

Kit Builder is a Docker Hardened Images workload for building Sandbox Kits. It includes Docker Engine, Buildx, and QEMU emulators for cross-architecture builds. Docker Sandboxes starts the engine and selects the sbx-builder container-driver builder.

Kit Builder requires a local Docker Sandboxes runtime with com.docker.sandbox/dockerd@1 and com.docker.sandbox/kit-registry@1 support. Cloud Sandboxes currently supports neither capability, so sbx --cloud run sbx/kit-builder:latest is unsupported.

⁠Run

sbx run sbx/kit-builder:latest /path/to/workspace

Use a versioned tag from the Tags tab to pin this kit release. The sbx/kit-builder tags mirror the corresponding dhi/kit-builder tags after a successful build.

⁠Authentication and configuration

Inside the sandbox, build a kit with the selected builder.

docker buildx build --platform linux/amd64,linux/arm64 -f kit.yaml .

Add --output type=oci,dest=out.tar to export an OCI archive. The Docker store persists across sandbox restarts and provides the build cache. It is not retained after sandbox deletion.

Builds can fetch arbitrary registries, package repositories, and source hosts, subject to host and organization policy. This workload has no general package manager or development toolchain.

Remote BuildKit access is off by default. Set the create-time kit argument buildkitExpose=true only when the runtime binds its published endpoint to host loopback. The endpoint is an unauthenticated root build API. Read the assigned port from sbx kit builder status before creating a remote Buildx client.

  • sbx/shell⁠ provides a general development workload. Kit Builder provides the dedicated build engine.

⁠Source and security

For runtime setup, see the Docker Sandboxes documentation⁠. For provenance, SBOM, VEX, and image verification, see the Docker Hardened Images documentation⁠.

Docker and the Docker logo are trademarks or registered trademarks of Docker, Inc. Product names and logos do not imply sponsorship or endorsement.