docker secret create

Description

Create a secret from a file or STDIN as content

Usage

docker secret create [OPTIONS] SECRET file|-

Options

Name, shorthand	Default	Description
--label, -l		Secret labels

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.

Examples

Create a secret

$ echo <secret> | docker secret create my_secret -
mhv17xfe3gh6xc4rij5orpfds

$ docker secret ls
ID                          NAME                    CREATED                                   UPDATED                                   SIZE
mhv17xfe3gh6xc4rij5orpfds   my_secret               2016-10-27 23:25:43.909181089 +0000 UTC   2016-10-27 23:25:43.909181089 +0000 UTC   1679

Create a secret with a file

$ docker secret create my_secret ./secret.json

mhv17xfe3gh6xc4rij5orpfds

$ docker secret ls

ID                          NAME                    CREATED                                   UPDATED                                   SIZE
mhv17xfe3gh6xc4rij5orpfds   my_secret               2016-10-27 23:25:43.909181089 +0000 UTC   2016-10-27 23:25:43.909181089 +0000 UTC   1679

Create a secret with labels

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

jtn7g6aukl5ky7nr9gvwafoxh

$ docker secret inspect my_secret

[
    {
        "ID": "jtn7g6aukl5ky7nr9gvwafoxh",
        "Version": {
            "Index": 541
        },
        "CreatedAt": "2016-11-03T20:54:12.924766548Z",
        "UpdatedAt": "2016-11-03T20:54:12.924766548Z",
        "Spec": {
            "Name": "my_secret",
            "Labels": {
                "env": "dev",
                "rev": "20161102"
            },
            "Data": null
        },
        "Digest": "sha256:4212a44b14e94154359569333d3fc6a80f6b9959dfdaff26412f4b2796b1f387",
        "SecretSize": 1679
    }
]