docker config inspect

Estimated reading time: 3 minutes


Display detailed information on one or more configs

Swarm This command works with the Swarm orchestrator.

Usage

$ docker config inspect [OPTIONS] CONFIG [CONFIG...]

Refer to the options section for an overview of available OPTIONS for this command.

Description

Inspects the specified config.

By default, this renders all results in a JSON array. If a format is specified, the given template will be executed for each result.

Go’s text/template package describes all the details of the format.

For detailed information about using configs, refer to store configuration data using Docker Configs.

Note

This is a cluster management command, and must be executed on a swarm manager node. To learn about managers and workers, refer to the Swarm mode section in the documentation.

For example uses of this command, refer to the examples section below.

Options

Name, shorthand Default Description
--format , -f Format the output using the given Go template
--pretty Print the information in a human friendly format

Examples

Inspect a config by name or ID

You can inspect a config, either by its name, or ID

For example, given the following config:

$ docker config ls

ID                          NAME                CREATED             UPDATED
eo7jnzguqgtpdah3cm5srfb97   my_config           3 minutes ago       3 minutes ago
$ docker config inspect config.json

The output is in JSON format, for example:

[
  {
    "ID": "eo7jnzguqgtpdah3cm5srfb97",
    "Version": {
      "Index": 17
    },
    "CreatedAt": "2017-03-24T08:15:09.735271783Z",
    "UpdatedAt": "2017-03-24T08:15:09.735271783Z",
    "Spec": {
      "Name": "my_config",
      "Labels": {
        "env": "dev",
        "rev": "20170324"
      },
      "Data": "aGVsbG8K"
    }
  }
]

Formatting

You can use the --format option to obtain specific information about a config. The following example command outputs the creation time of the config.

$ docker config inspect --format='{{.CreatedAt}}' eo7jnzguqgtpdah3cm5srfb97

2017-03-24 08:15:09.735271783 +0000 UTC

Parent command

Command Description
docker config Manage Docker configs
Command Description
docker config create Create a config from a file or STDIN
docker config inspect Display detailed information on one or more configs
docker config ls List configs
docker config rm Remove one or more configs