github.com/anth0d/nomad@v0.0.0-20221214183521-ae3a0a2cad06/website/content/docs/commands/acl/bootstrap.mdx (about)

     1  ---
     2  layout: docs
     3  page_title: 'Commands: acl bootstrap'
     4  description: |
     5    The bootstrap command is used to create the initial ACL token.
     6  ---
     7  
     8  # Command: acl bootstrap
     9  
    10  The `acl bootstrap` command is used to bootstrap the initial ACL token.
    11  
    12  ## Usage
    13  
    14  ```plaintext
    15  nomad acl bootstrap [options]
    16  ```
    17  
    18  The `acl bootstrap` command can be used in two ways: 
    19  - If you provide no arguments it will return a system generated bootstrap token.
    20  - If you would like to provide an operator generated token it is possible to provide the token
    21  using a file `acl bootstrap [path]`. The Token can be read from stdin by setting the path to "-". 
    22  Please make sure you secure this token in an apropriate manner as it could be written to your terminal history.
    23  
    24  ## General Options
    25  
    26  @include 'general_options_no_namespace.mdx'
    27  
    28  ## Bootstrap Options
    29  
    30  - `-json` : Output the bootstrap response in JSON format.
    31  - `-t` : Format and display the deployments using a Go template.
    32  
    33  ## Examples
    34  
    35  Bootstrap the initial token without arguments:
    36  
    37  ```shell-session
    38  $ nomad acl bootstrap
    39  Accessor ID  = 5b7fd453-d3f7-6814-81dc-fcfe6daedea5
    40  Secret ID    = 9184ec35-65d4-9258-61e3-0c066d0a45c5
    41  Name         = Bootstrap Token
    42  Type         = management
    43  Global       = true
    44  Policies     = n/a
    45  Create Time  = 2017-09-11 17:38:10.999089612 +0000 UTC
    46  Create Index = 7
    47  Modify Index = 7
    48  ```
    49  
    50  Bootstrap the initial token with provided token:
    51  
    52  root.token file
    53  ```shell-session
    54  2b778dd9-f5f1-6f29-b4b4-9a5fa948757a
    55  ```
    56  
    57  ```shell-session
    58  $ nomad acl bootstrap root.token
    59  Accessor ID  = 5b7fd453-d3f7-6814-81dc-fcfe6daedea5
    60  Secret ID    = 2b778dd9-f5f1-6f29-b4b4-9a5fa948757a
    61  Name         = Bootstrap Token
    62  Type         = management
    63  Global       = true
    64  Policies     = n/a
    65  Create Time  = 2017-09-11 17:38:10.999089612 +0000 UTC
    66  Create Index = 7
    67  Modify Index = 7
    68  ```
    69  
    70  Bootstrap the initial token with provided token using stdin 
    71  
    72  ```shell-session
    73  $ nomad acl bootstrap -
    74  2b778dd9-f5f1-6f29-b4b4-9a5fa948757a
    75  EOF
    76  Accessor ID  = 5b7fd453-d3f7-6814-81dc-fcfe6daedea5
    77  Secret ID    = 2b778dd9-f5f1-6f29-b4b4-9a5fa948757a
    78  Name         = Bootstrap Token
    79  Type         = management
    80  Global       = true
    81  Policies     = n/a
    82  Create Time  = 2017-09-11 17:38:10.999089612 +0000 UTC
    83  Create Index = 7
    84  Modify Index = 7
    85  ```