Registry /
devops / cdktf-cdktf-provider-docker
Install & Compatibility
Where this runs
tested against v12.0.3 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 31.6MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 3.4s · import 0.000s · 32MB
31MB installed
● package 31MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
DockerProvider
✓ from cdktf_cdktf_provider_docker.provider import DockerProvider
✗ from cdktf_cdktf_provider_docker import DockerProvider
DockerProvider is inside the provider submodule, not top-level
Container
✓ from cdktf_cdktf_provider_docker.container import Container
✗ from cdktf_cdktf_provider_docker import Container
Resources are in submodules named by resource
Image
✓ from cdktf_cdktf_provider_docker.image import Image
✗ from cdktf_cdktf_provider_docker import Image
Same submodule pattern
Basic example: creates an Nginx image and container. Run with cdktf deploy.
from cdktf import App, TerraformStack
from cdktf_cdktf_provider_docker.provider import DockerProvider
from cdktf_cdktf_provider_docker.container import Container
from cdktf_cdktf_provider_docker.image import Image
app = App()
stack = TerraformStack(app, "docker-example")
DockerProvider(stack, "docker")
image = Image(stack, "nginx-image",
name="nginx:latest",
keep_locally=False
)
container = Container(stack, "nginx-container",
image=image.latest,
name="example-nginx",
ports=[{
"internal": 80,
"external": 8080
}]
)
app.synth()
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'cdktf_cdktf_provider_docker'
Missing pip install or wrong Python environment.
fixRun `pip install cdktf-cdktf-provider-docker` and ensure you are in the correct virtual environment.
ImportError: cannot import name 'DockerProvider' from 'cdktf_cdktf_provider_docker'
Using wrong import path; DockerProvider is in a submodule.
fixUse `from cdktf_cdktf_provider_docker.provider import DockerProvider`
cdktf: error: cannot find module for provider docker
Provider not initialized via cdktf provider add.
fixRun `cdktf provider add docker` in your project directory.
Upgrade
Version history
12.0.3latest on PyPI · released Dec 10, 2025
Audit
Dependencies
cdktfrequiredCore CDKTF library required