Docker Provider: Installation & Configuration

The Pulumi Docker provider uses the Docker SDK to manage resources.

Installation

The Docker provider is available as a package in all Pulumi languages:

• JavaScript/TypeScript: @pulumi/docker
• Python: pulumi-docker
• Go: github.com/pulumi/pulumi-docker/sdk/v4/go/docker
• .NET: Pulumi.Docker
• Java: com.pulumi/docker

Configuring The Provider

Pulumi relies on the Docker SDK to authenticate requests from your computer to Docker. Your credentials are never sent to pulumi.com.

Once the credentials are obtained, there are two ways to communicate your configuration tokens to Pulumi:

1. Set the environment variable DOCKER_HOST:

   $ export DOCKER_HOST=tcp://127.0.0.1:2376/
   

2. Set them using configuration, if you prefer that they be stored alongside your Pulumi stack for easy multi-user access:

   $ pulumi config set docker:host tcp://127.0.0.1:2376/
   

Alternative for Windows users:

Use the following PowerShell command to add reference the pipe used by Docker Engine on your machine.

pulumi config set docker:host "npipe:////.//pipe//docker_engine"