# community.docker.docker connection – Run tasks in docker containers

Note

This connection plugin is part of the community.docker collection (version 3.4.6).

To install it, use: `ansible-galaxy collection install community.docker`.

To use it in a playbook, specify: `community.docker.docker`.

## Synopsis

- Run commands or put/fetch files to an existing docker container.

- Uses the Docker CLI to execute commands in the container. If you prefer to directly connect to the Docker daemon, use the community.docker.docker_api connection plugin.

## Parameters

Parameter | Comments
--- | ---

container_timeout

integer

Controls how long we can wait to access reading output from the container once execution started.

Default: `10`

Configuration:

- INI entries:

      [defaults]
      timeout = 10

      [docker_connection]
      timeout = 10

  added in community.docker 2.2.0

- Environment variable: `ANSIBLE_TIMEOUT`

- Environment variable: `ANSIBLE_DOCKER_TIMEOUT`

  added in community.docker 2.2.0

- Variable: ansible_docker_timeout

  added in community.docker 2.2.0

- CLI argument: –timeout

docker_extra_args

string

Extra arguments to pass to the docker command line.

Default: `""`

Configuration:

- INI entry:

      [docker_connection]
      extra_cli_args = ""

- Variable: ansible_docker_extra_args

remote_addr

string

The name of the container you want to access.

Default: `"inventory_hostname"`

Configuration:

- Variable: inventory_hostname

- Variable: ansible_host

- Variable: ansible_docker_host

remote_user

string

The user to execute as inside the container.

If Docker is too old to allow this (< 1.7), the one set by Docker itself will be used.

Configuration:

- INI entry:

      [defaults]
      remote_user = VALUE

- Environment variable: `ANSIBLE_REMOTE_USER`

- Variable: ansible_user

- Variable: ansible_docker_user

- Keyword: remote_user

- CLI argument: –user

### Authors

- Lorin Hochestein

- Leendert Brouwer

Hint

Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up.

### Collection links

Issue Tracker Repository (Sources) Submit a bug report Request a feature Communication