/Docker 19

docker secret create


Create a secret from a file or STDIN as content

API 1.25+ The client and daemon API must both be at least 1.25 to use this command. Use the docker version command on the client to check your client and daemon API versions.

Swarm This command works with the Swarm orchestrator.


docker secret create [OPTIONS] SECRET [file|-]


Name, shorthand Default Description
--driver , -d API 1.31+
Secret driver
--label , -l Secret labels
--template-driver API 1.37+
Template driver

Parent command

Command Description
docker secret Manage Docker secrets
Command Description
docker secret create Create a secret from a file or STDIN as content
docker secret inspect Display detailed information on one or more secrets
docker secret ls List secrets
docker secret rm Remove one or more secrets

Extended description

Creates a secret using standard input or from a file for the secret content. You must run this command on a manager node.

For detailed information about using secrets, refer to manage sensitive data with Docker secrets.


Create a secret

$ printf <secret> | docker secret create my_secret -


$ docker secret ls

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

Create a secret with a file

$ docker secret create my_secret ./secret.json


$ docker secret ls

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

Create a secret with labels

$ docker secret create --label env=dev \
                       --label rev=20170324 \
                       my_secret ./secret.json

$ docker secret inspect my_secret

        "ID": "eo7jnzguqgtpdah3cm5srfb97",
        "Version": {
            "Index": 17
        "CreatedAt": "2017-03-24T08:15:09.735271783Z",
        "UpdatedAt": "2017-03-24T08:15:09.735271783Z",
        "Spec": {
            "Name": "my_secret",
            "Labels": {
                "env": "dev",
                "rev": "20170324"

© 2019 Docker, Inc.
Licensed under the Apache License, Version 2.0.
Docker and the Docker logo are trademarks or registered trademarks of Docker, Inc. in the United States and/or other countries.
Docker, Inc. and other parties may also have trademark rights in other terms used herein.