> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexagon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# dockerPullImage

> Pull an image from a remote Docker container registry e.g. Docker Hub, Amazon ECR, Microsoft ACR , with specific or multiple tags. To pull the image w

Pull an image from a remote Docker container registry e.g. Docker Hub, Amazon ECR, Microsoft ACR , with specific or multiple tags.  To pull the image we need to configure the Docker Registry Account, Please refer to the link to set up the Docker Registry Account: [Docker Registry Setup For Cloud Providers](https://docs.flexagon.com/flexdeploy-11-0-documentation/flexdeploy-plugin-guides/flexdeploy-docker-plugin-guide/docker-plugin-appendix/docker-registry-setup-for-cloud-providers.md) .  Depending on the size of the image it is not uncommon for this operation to take several minutes to complete. This operation uses Docker CLI, it requires the docker executable to be on the path of the docker endpoint.

# Target Properties

<table><colgroup><col /><col /><col /><col /></colgroup><tbody><tr><th>**Property Name**</th><th>**Property Code**</th><th>**Required**</th><th>**Description**</th></tr><tr><td>Docker Unix Socket</td><td>`FDDKR_UNIX_SOCKET`</td><td>No</td><td>The socket the Docker daemon listens on. Required if Docker Server and Docker Port are not set. Default value is \[/var/run/docker.sock]</td></tr><tr><td>Docker Server Address</td><td>`FDDKR_DOCKER_SERVER`</td><td>No</td><td>The IP address of the Docker server.  Required if Docker Unix Socker is not set.</td></tr><tr><td>Docker Port</td><td>`FDDKR_DOCKER_PORT`</td><td>No</td><td>The port the Docker service is listening on.  Required if Docker Unix Socker is not set.</td></tr><tr><td>Docker Registry Account</td><td>`FDDKR_REGISTRY_ACCOUNT_CODE`</td><td>No</td><td>The Docker Registry Account Code. The plugin input `FDDKR_INP_REGISTRY_ACCOUNT_CODE` takes precedence over this property.Please refer to the link to set up the Docker Registry Account: [Docker Registry Setup For Cloud Providers](https://docs.flexagon.com/flexdeploy-11-0-documentation/flexdeploy-plugin-guides/flexdeploy-docker-plugin-guide/docker-plugin-appendix/docker-registry-setup-for-cloud-providers.md)</td></tr></tbody></table>

# Project Properties

<table><colgroup><col /><col /><col /><col /></colgroup><tbody><tr><th>**Property Name**</th><th>**Property Code**</th><th>**Required**</th><th>**Description**</th></tr><tr><td>Docker Repository Name</td><td>`FDDKR_IMAGE_NAME`</td><td>No</td><td>The name of the image/repository to pull. The plugin input `FDDKR_INP_IMAGE_NAME` takes precedence over this property.</td></tr><tr><td>Docker Image Tag</td><td>`FDDKR_IMAGE_TAG`</td><td>No</td><td>The specific tag to pull or Use comma-separated values to specify multiple tags. For example: 1.0,2.0,3.0 . The plugin input `FDDKR_INP_IMAGE_TAG` takes precedence over this property.</td></tr></tbody></table>

# Inputs

<table><colgroup><col /><col /><col /><col /></colgroup><tbody><tr><th>**Input Name**</th><th>**Input Code**</th><th>**Required**</th><th>**Description**</th></tr><tr><td>Docker Repository Name</td><td>`FDDKR_INP_IMAGE_NAME`</td><td>No</td><td>The name of the image/repository to pull. This input will take priority over the `FDDKR_IMAGE_NAME` project property.Note: If `FDDKR_IMAGE_NAME` or `FDDKR_INP_IMAGE_NAME` is specified with preceding “**/**”, then the registry address from `FDDKR_REGISTRY_ACCOUNT_CODE or FDDKR_INP_REGISTRY_ACCOUNT_CODE` will get auto prepended to form the full image name.***Example**: *`FDDKR_INP_IMAGE_NAME`*=/nginximage and registry address corresponding to the *`FDDKR_REGISTRY_ACCOUNT_CODE`* is *[*898334.dkr.ecr.us-east-1.amazonaws.com*](http://898334718399.dkr.ecr.us-east-1.amazonaws.com/)*, then plugin will consider the image name as *[*898334.dkr.ecr.us-east-1.amazonaws.com*](http://898334718399.dkr.ecr.us-east-1.amazonaws.com/)*/nginximage.*</td></tr><tr><td>Image Tag</td><td>`FDDKR_INP_IMAGE_TAG`</td><td>No</td><td>The specific tag to pull or Use comma-separated values to specify multiple tags. For example: 1.0,2.0,3.0 . This input will take priority over the `FDDKR_IMAGE_TAG` project property.</td></tr><tr><td>Docker Registry Account</td><td>`FDDKR_INP_REGISTRY_ACCOUNT_CODE`</td><td>No</td><td>The Docker Registry Account Code. There are a couple different spots to specify this for convenience.In order of precedence:<ul><li>This plugin input</li><li>Target Property</li></ul>Please refer to the link to set up the Docker Registry Account: [Docker Registry Setup For Cloud Providers](https://docs.flexagon.com/flexdeploy-11-0-documentation/flexdeploy-plugin-guides/flexdeploy-docker-plugin-guide/docker-plugin-appendix/docker-registry-setup-for-cloud-providers.md)</td></tr><tr><td>Additional Options</td><td>`FDDKR_INP_ADDITIONAL_PARAMS`</td><td>No</td><td>Add any additional options not listed above, which will be added to the pull command.</td></tr></tbody></table>

# Artifacts

This operation doesn’t consume or produce any artifacts.

# Endpoint Selection

This operation delegates the selection to the workflow developer to determine.

# Endpoint Execution

This operation will execute on any one of the selected endpoints and will be random in the determination of which one.

# Special Considerations

Depending on the bandwidth and image size this operation may take several minutes to complete.