{"id":23409,"library":"cdktf-cdktf-provider-docker","title":"CDKTF Docker Provider","description":"Prebuilt Terraform CDK (CDKTF) provider for Docker. Allows managing Docker resources (containers, images, networks, volumes) using TypeScript/Python/go/.NET. Current version: 12.0.3, requires Python ~=3.9. Released alongside CDKTF, follows provider versioning scheme.","status":"active","version":"12.0.3","language":"python","source_language":"en","source_url":"https://github.com/cdktf/cdktf-provider-docker","tags":["cdktf","terraform","docker","infrastructure"],"install":[{"cmd":"pip install cdktf-cdktf-provider-docker","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"Core CDKTF library required","package":"cdktf","optional":false}],"imports":[{"note":"DockerProvider is inside the provider submodule, not top-level","wrong":"from cdktf_cdktf_provider_docker import DockerProvider","symbol":"DockerProvider","correct":"from cdktf_cdktf_provider_docker.provider import DockerProvider"},{"note":"Resources are in submodules named by resource","wrong":"from cdktf_cdktf_provider_docker import Container","symbol":"Container","correct":"from cdktf_cdktf_provider_docker.container import Container"},{"note":"Same submodule pattern","wrong":"from cdktf_cdktf_provider_docker import Image","symbol":"Image","correct":"from cdktf_cdktf_provider_docker.image import Image"}],"quickstart":{"code":"from cdktf import App, TerraformStack\nfrom cdktf_cdktf_provider_docker.provider import DockerProvider\nfrom cdktf_cdktf_provider_docker.container import Container\nfrom cdktf_cdktf_provider_docker.image import Image\n\napp = App()\nstack = TerraformStack(app, \"docker-example\")\nDockerProvider(stack, \"docker\")\n\nimage = Image(stack, \"nginx-image\",\n    name=\"nginx:latest\",\n    keep_locally=False\n)\n\ncontainer = Container(stack, \"nginx-container\",\n    image=image.latest,\n    name=\"example-nginx\",\n    ports=[{\n        \"internal\": 80,\n        \"external\": 8080\n    }]\n)\n\napp.synth()","lang":"python","description":"Basic example: creates an Nginx image and container. Run with cdktf deploy."},"warnings":[{"fix":"Run `cdktf provider add docker` to handle version resolution automatically.","message":"The provider version must match the Terraform provider version (e.g., provider ~> 3.0 maps to cdktf-cdktf-provider-docker 12.x). Check compatibility matrix.","severity":"gotcha","affected_versions":">=2.0,<13.0"},{"fix":"Update to provider version 12.x and use keyword arguments. Refer to CDKTF migration guide.","message":"Breaking changes between CDKTF 0.x and 0.20+: resource constructors changed from positional arguments to keyword arguments, and import paths changed.","severity":"breaking","affected_versions":">=0.0,<12.0"},{"fix":"Use full submodule imports: `from cdktf_cdktf_provider_docker.provider import DockerProvider`","message":"Using old import paths like `from cdktf_cdktf_provider_docker import DockerProvider` is deprecated and will break in future.","severity":"deprecated","affected_versions":">=12.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `pip install cdktf-cdktf-provider-docker` and ensure you are in the correct virtual environment.","cause":"Missing pip install or wrong Python environment.","error":"ModuleNotFoundError: No module named 'cdktf_cdktf_provider_docker'"},{"fix":"Use `from cdktf_cdktf_provider_docker.provider import DockerProvider`","cause":"Using wrong import path; DockerProvider is in a submodule.","error":"ImportError: cannot import name 'DockerProvider' from 'cdktf_cdktf_provider_docker'"},{"fix":"Run `cdktf provider add docker` in your project directory.","cause":"Provider not initialized via cdktf provider add.","error":"cdktf: error: cannot find module for provider docker"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}