docker secret create
Estimated reading time: 2 minutesDescription
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.
Usage
docker secret create [OPTIONS] SECRET [file|-]
Options
Name, shorthand | Default | Description |
--driver , -d |
API 1.37+ Secret driver |
|
--label , -l |
Secret labels | |
--template-driver |
Template driver |
Parent command
Command | Description |
---|---|
docker secret | Manage Docker secrets |
Related commands
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.
Examples
Create a secret
$ printf <secret> | docker secret create my_secret -
onakdyv307se2tl7nl20anokv
$ 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
dg426haahpi5ezmkkj5kyl3sn
$ 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
eo7jnzguqgtpdah3cm5srfb97
$ 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"
}
}
}
]