---
id: pulumi-docker-build
version: "0.0.22"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pulumi-docker-build — A Pulumi provider for building modern Docker images with buildx and BuildKit.

License: permissive · Maintenance: active · Downloads: 806.1K/mo

## What it is and what it does

This is a Pulumi resource provider that lets you define Docker image builds as infrastructure code using Pulumi's programming model. It wraps Docker's buildx and BuildKit tooling, allowing you to declare and manage image builds declaratively rather than through imperative shell commands. The provider is distinct from the general-purpose Docker provider, which handles container runtime and networking; this one focuses exclusively on the build process itself.

You use it within a Pulumi program to specify build configurations, then Pulumi orchestrates the actual build via buildx and BuildKit. It depends on pulumi, parver, semver, and typing-extensions, and requires Python 3.9 or later.

Use it for:

- Define multi-platform Docker builds as Pulumi stack code alongside other infrastructure
- Automate image builds as part of a larger infrastructure deployment within the Pulumi workflow
- Version and track Docker image build configurations in version control as Pulumi code
- Integrate BuildKit advanced features into infrastructure-as-code pipelines

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Pulumi provider for building Docker images using buildx and BuildKit, enabling infrastructure-as-code management of modern Docker image builds.

Yes, if you are already using Pulumi and need to build Docker images as part of infrastructure automation. The package is actively maintained, has low install friction, carries a permissive license, and has no known vulnerabilities. It fills a specific gap for teams that want image builds in their Pulumi stacks. If you are not using Pulumi or only need ad-hoc Docker builds, this is not the right tool.

## Install

pip install pulumi-docker-build
uv add pulumi-docker-build
poetry add pulumi-docker-build

## Installing pulumi-docker-build

Before you install: Low install friction with a pure-Python wheel. Actively maintained with a recent release and an active repository.

License in practice: Apache-2.0 permissive license allows use in most commercial and open-source projects without significant restrictions.

Quickstart:

pip install pulumi-docker-build

import pulumi_docker_build as docker_build

image = docker_build.Image('my-image', context='./app')

Requires Python 3.9 or later and Docker with buildx and BuildKit support installed on the system.

Verify before relying:

- Whether this provider is suitable for production workloads or still in early/experimental stages
- Specific buildx and BuildKit version compatibility requirements

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 806.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pulumi docker build provider, docker buildx infrastructure as code, buildkit image automation, pulumi container image building, docker build resource provider, infrastructure-as-code, docker-automation

[View on SkillFed](https://skillfed.io/packages/pulumi-docker-build) · [View on PyPI](https://pypi.org/project/pulumi-docker-build/)