1# secret create
2
3<!---MARKER_GEN_START-->
4Create a secret from a file or STDIN as content
5
6### Options
7
8| Name | Type | Default | Description |
9|:------------------------------------|:---------|:--------|:----------------|
10| `-d`, `--driver` | `string` | | Secret driver |
11| [`-l`](#label), [`--label`](#label) | `list` | | Secret labels |
12| `--template-driver` | `string` | | Template driver |
13
14
15<!---MARKER_GEN_END-->
16
17## Description
18
19Creates a secret using standard input or from a file for the secret content.
20
21For detailed information about using secrets, refer to [manage sensitive data with Docker secrets](https://docs.docker.com/engine/swarm/secrets/).
22
23> **Note**
24>
25> This is a cluster management command, and must be executed on a swarm
26> manager node. To learn about managers and workers, refer to the
27> [Swarm mode section](https://docs.docker.com/engine/swarm/) in the
28> documentation.
29
30## Examples
31
32### Create a secret
33
34```console
35$ printf "my super secret password" | docker secret create my_secret -
36
37onakdyv307se2tl7nl20anokv
38
39$ docker secret ls
40
41ID NAME CREATED UPDATED
42onakdyv307se2tl7nl20anokv my_secret 6 seconds ago 6 seconds ago
43```
44
45### Create a secret with a file
46
47```console
48$ docker secret create my_secret ./secret.json
49
50dg426haahpi5ezmkkj5kyl3sn
51
52$ docker secret ls
53
54ID NAME CREATED UPDATED
55dg426haahpi5ezmkkj5kyl3sn my_secret 7 seconds ago 7 seconds ago
56```
57
58### <a name="label"></a> Create a secret with labels (--label)
59
60```console
61$ docker secret create \
62 --label env=dev \
63 --label rev=20170324 \
64 my_secret ./secret.json
65
66eo7jnzguqgtpdah3cm5srfb97
67```
68
69```console
70$ docker secret inspect my_secret
71
72[
73 {
74 "ID": "eo7jnzguqgtpdah3cm5srfb97",
75 "Version": {
76 "Index": 17
77 },
78 "CreatedAt": "2017-03-24T08:15:09.735271783Z",
79 "UpdatedAt": "2017-03-24T08:15:09.735271783Z",
80 "Spec": {
81 "Name": "my_secret",
82 "Labels": {
83 "env": "dev",
84 "rev": "20170324"
85 }
86 }
87 }
88]
89```
90
91
92## Related commands
93
94* [secret inspect](secret_inspect.md)
95* [secret ls](secret_ls.md)
96* [secret rm](secret_rm.md)
View as plain text