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

Extended description

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

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


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
--driver , -d API 1.31+
Secret driver
--label , -l Secret labels
--template-driver API 1.37+
Template driver


Create a secret

$ printf "my super secret password" | 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"

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