NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #3918 most downloaded on PyPI
A Pulumi package for interacting with Docker in Pulumi programs
Last release 7 days ago
28 Sep 2026
Ships on a steady schedule
a new release about every 1 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
842 releases · first in 2018
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
If a user provides a Dockerfile, the path specified must be absolute, or relative to the Pulumi context, not the Docker build context. The dockerfile
If a user provides a Dockerfile, the path specified must be absolute, or relative to the Pulumi context, not the Docker build context. The dockerfile field remains optional, and if left blank, we assume traditional location of Dockerfile within the Docker build context. Read specific details on the pull request
LocalImageName: Deprecated. Use ImageName in conjunction with SkipPush:true.
The Docker Image resource is now a full Pulumi Custom Resource. It uses the docker-go client library instead of invoking the Docker CLI.
As a result there are updates to the behavior of the Image resource and supporting types, as well as some minor name changes.
docker.Image: New Features and Bug Fixes~Because the Image resource does not contain any backend state, migrating to this version does not need any resource imports or stack updates. For most use cases, it should be as straightforward as updating your pulumi-docker version and adjusting your code to reflect the updated types.~
UPDATE via #563
Because the new Image resource represents a change in how it is associated with a provider, a one-time manual stack update using pulumi state delete may be required.
The steps are as follows:
pulumi stack --show-urnspulumi state delete <any Image URN> <--- this is safe to do, as Images have no cloud statepulumi upThis version of the provider defaults to building images with Buildkit. If you would like to keep the classic Docker builder, set new field Build.BuilderVersion to BuilderV1 to continue using the classic Docker builder.
LocalImageName: Deprecated. Use ImageName in conjunction with SkipPush:true.Build: Updated. No longer a required input; defaults to using current directory as build context. No longer accepts a string for a custom build context. Use Build.Context instead.
Build.Platform: New. Specify a target platform for the image build. Note that this field supports a single value currently, not a list of target platforms.Build.CacheFrom: Updated. No longer accepts a boolean. Specify images in Build.CacheFrom.Images. To fully leverage using a registry cache, images must be built with a cache manifest by passing "BUILDKIT_INLINE_CACHE": "1" to `Build.Args
},
Build.CacheFrom.Images: New. Replaces Build.CacheFrom.Stages. Defines a list of images to use as build cache.Build.CacheFrom.Stages: Deprecated. Replaced by Build.CacheFrom.Images.Build.BuilderVersion: New. Defaults to BuilderBuildKit. Set to BuilderV1 to continue using the classic Docker builder.ExtraOptions: Deprecated. This was a way to pass arbitrary CLI flags to the Docker CLI.
These are being implemented as top-level fields; currently available are:
Build.PlatformBuild.TargetBuild.CacheFromEnv: Deprecated. This field’s use case was mainly for passing DOCKER_BUILDKIT=1 to the CLI invocation of docker build. Use Build.BuilderVersion instead. You do not need to specify Build.BuilderVersion if you are running in Buildkit mode, which is the default.ImageName: Updated. Must be of fully qualified repository format, i.e. registry.domain.abc/repositoryname/image. The tag will be inferred as :latest unless otherwise specified. Docker.io will no longer be automatically inferred.Id: Deprecated. Use ImageName for a unique identifier.Digest: Deprecated as of an older version of pulumi-docker v3; this version removes it entirely.C Sharp Docker.ImageRegistry → Docker.Inputs.RegistryArgs Docker.DockerBuild → Docker.Inputs.DockerBuildArgs
Go docker.ImageRegistry → docker.Registry
Python DockerBuild → DockerBuildArgs ImageRegistry → RegistryArgs
CacheFrom via input credentials on Image by @guineveresaenger in https://github.com/pulumi/pulumi-docker/pull/500Full Changelog: https://github.com/pulumi/pulumi-docker/compare/v3.6.1...v4.0.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Alias Docker image to avoid deletion on upgrade to v4 by @guineveresaenger in https://github.com/pulumi/pulumi-docker/pull/483
Full Changelog: https://github.com/pulumi/pulumi-docker/compare/v4.0.0-alpha.3...v4.0.0-alpha.4
Deprecate extraOptions and env by @guineveresaenger in https://github.com/pulumi/pulumi-docker/pull/468
Full Changelog: https://github.com/pulumi/pulumi-docker/compare/v4.0.0-alpha.2...v4.0.0-alpha.3
Set Registry Server Name by @guineveresaenger in https://github.com/pulumi/pulumi-docker/pull/465
Full Changelog: https://github.com/pulumi/pulumi-docker/compare/v4.0.0-alpha.1...v4.0.0-alpha.2
Update GitHub Actions workflows. by @pulumi-bot in https://github.com/pulumi/pulumi-docker/pull/432
Full Changelog: https://github.com/pulumi/pulumi-docker/compare/v4.0.0-alpha.0...v4.0.0-alpha.1
This is a preview of the Docker Image resource as a fully schematized Pulumi resource. This aims to address a number of issues with this provider.
This is a preview of the Docker Image resource as a fully schematized Pulumi resource. This aims to address a number of issues with this provider.
Please read What Changed for information and discussion on this preview.
This release is mostly comprised of the changes made in #413. Please see master for further updates as well.
Nothing published for this version
Nothing published for this version
cecc28c Update Bridge to v3.33.0
8e0b505 Upgrade to v 2.23.0 of the Docker Terraform Provider
Nothing published for this version
Nothing published for this version
Nothing published for this version
50c41eb Fix passing of env variables to docker build
Nothing published for this version
Nothing published for this version
9d280bb Upgrade to v2.20.2 of the Docker Terraform Provider
038b9e9 Upgrade to v2.20.0 of the Docker Terraform Provider
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →