docker config create

Estimated reading time: 2 minutes

Create a config from a file or STDIN

Swarm This command works with the Swarm orchestrator.


$ docker config create [OPTIONS] CONFIG file|-

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


Creates a config using standard input or from a file for the config content.

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


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.


Name, shorthand Default Description
--label , -l Config labels
--template-driver Template driver


Create a config

$ printf <config> | docker config create my_config -


$ docker config ls

ID                          NAME                CREATED             UPDATED
onakdyv307se2tl7nl20anokv   my_config           6 seconds ago       6 seconds ago

Create a config with a file

$ docker config create my_config ./config.json


$ docker config ls

ID                          NAME                CREATED             UPDATED
dg426haahpi5ezmkkj5kyl3sn   my_config           7 seconds ago       7 seconds ago

Create a config with labels

$ docker config create \
    --label env=dev \
    --label rev=20170324 \
    my_config ./config.json

$ docker config inspect my_config

        "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"

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