github.com/khulnasoft/cli@v0.0.0-20240402070845-01bcad7beefa/docs/reference/commandline/secret_create.md (about)

     1  # secret create
     2  
     3  <!---MARKER_GEN_START-->
     4  Create 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  
    19  Creates a secret using standard input or from a file for the secret content.
    20  
    21  For 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  
    37  onakdyv307se2tl7nl20anokv
    38  
    39  $ docker secret ls
    40  
    41  ID                          NAME                CREATED             UPDATED
    42  onakdyv307se2tl7nl20anokv   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  
    50  dg426haahpi5ezmkkj5kyl3sn
    51  
    52  $ docker secret ls
    53  
    54  ID                          NAME                CREATED             UPDATED
    55  dg426haahpi5ezmkkj5kyl3sn   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  
    66  eo7jnzguqgtpdah3cm5srfb97
    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)