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

# pulumi-docker — A Pulumi package for interacting with Docker in Pulumi programs

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

## What it is and what it does

Pulumi-docker is a resource provider that lets you define and manage Docker resources—containers, images, networks, volumes, and registries—declaratively within Pulumi infrastructure-as-code programs. It integrates Docker management into the same Pulumi workflow you use for cloud infrastructure, allowing you to version-control, test, and deploy Docker configurations alongside other infrastructure.

The package acts as a bridge between Pulumi's programming model and Docker's API, exposing Docker resources as Pulumi resource types. You write Python (or another Pulumi-supported language) to declare what Docker resources you want, and Pulumi handles the provisioning and lifecycle management. It's designed for teams already using Pulumi who want to manage containerization as part of their broader infrastructure automation.

Use it for:

- Define and deploy Docker containers, images, and networks as part of a Pulumi infrastructure stack
- Automate Docker image builds and registry pushes within an infrastructure-as-code workflow
- Manage Docker volumes and networks alongside cloud resources in a single Pulumi program
- Version-control Docker configurations and infrastructure together in a single codebase
- Integrate Docker resource provisioning into CI/CD pipelines using Pulumi automation

## Worth the install?

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

Pulumi provider for managing Docker resources (containers, images, networks, volumes) as code within Pulumi infrastructure programs.

Yes, if you are already using Pulumi and need to manage Docker resources as part of your infrastructure code. The package is actively maintained, has low install friction, carries a permissive license, and has no known vulnerabilities. Install only after ensuring Pulumi CLI is set up; it is not a standalone Docker client.

## Install

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

## Installing pulumi-docker

Before you install: Low friction install with a pure-Python wheel. Actively maintained as of 2026-06-26 with recent commits. Requires Pulumi CLI to be installed separately before use.

License in practice: Apache-2.0 permissive license allows commercial use, modification, and redistribution with minimal restrictions.

Quickstart:

pip install pulumi_docker

import pulumi
import pulumi_docker as docker

image = docker.Image('my-image', image_name='my-app:latest')

Pulumi CLI must be installed and configured before this package can be used; requires Python >=3.9

Verify before relying:

- Whether this provider supports all current Docker API features or only a subset
- Compatibility with specific Docker daemon versions or configurations
- Performance characteristics when managing large numbers of Docker resources

## Package facts

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

## Tags

pulumi docker provider, infrastructure as code docker, docker resource management pulumi, containerized infrastructure automation, docker provisioning pulumi, container orchestration code, docker iac provider, infrastructure-as-code, docker-provisioning, pulumi-ecosystem

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