2018-10-24 14:24:29 +00:00
|
|
|
---
|
2020-04-07 18:55:19 +00:00
|
|
|
layout: docs
|
|
|
|
|
page_title: 'Commands: ACL Bootstrap'
|
2020-04-07 23:56:08 +00:00
|
|
|
sidebar_title: 'bootstrap'
|
2020-04-07 18:55:19 +00:00
|
|
|
sidebar_current: docs-commands-acl-bootstrap
|
2018-10-24 14:24:29 +00:00
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Consul ACL Bootstrap
|
|
|
|
|
|
|
|
|
|
Command: `consul acl bootstrap`
|
|
|
|
|
|
|
|
|
|
The `acl bootstrap` command will request Consul to generate a new token with unlimited privileges to use
|
|
|
|
|
for management purposes and output its details. This can only be done once and afterwards bootstrapping
|
|
|
|
|
will be disabled. If all tokens are lost and you need to bootstrap again you can follow the bootstrap
|
2019-12-06 17:38:52 +00:00
|
|
|
[reset procedure](https://learn.hashicorp.com/consul/security-networking/acl-troubleshooting?utm_source=consul.io&utm_medium=docs#reset-the-acl-system).
|
2018-10-24 14:24:29 +00:00
|
|
|
|
2020-04-09 23:46:54 +00:00
|
|
|
The ACL system can also be bootstrapped via the [HTTP API](/api/acl/acl#bootstrap-acls).
|
2018-10-24 14:24:29 +00:00
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
Usage: `consul acl bootstrap [options]`
|
|
|
|
|
|
|
|
|
|
#### API Options
|
|
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
@include 'http_api_options_client.mdx'
|
2020-04-07 23:56:08 +00:00
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
@include 'http_api_options_server.mdx'
|
2018-10-24 14:24:29 +00:00
|
|
|
|
2020-03-26 16:03:22 +00:00
|
|
|
#### Command Options
|
2020-04-07 18:55:19 +00:00
|
|
|
|
|
|
|
|
- `-format={pretty|json}` - Command output format. The default value is `pretty`.
|
2020-03-26 16:03:22 +00:00
|
|
|
|
2018-10-24 14:24:29 +00:00
|
|
|
The output looks like this:
|
|
|
|
|
|
|
|
|
|
```text
|
|
|
|
|
AccessorID: 4d123dff-f460-73c3-02c4-8dd64d136e01
|
|
|
|
|
SecretID: 86cddfb9-2760-d947-358d-a2811156bf31
|
|
|
|
|
Description: Bootstrap Token (Global Management)
|
|
|
|
|
Local: false
|
|
|
|
|
Create Time: 2018-10-22 11:27:04.479026 -0400 EDT
|
|
|
|
|
Policies:
|
|
|
|
|
00000000-0000-0000-0000-000000000001 - global-management
|
|
|
|
|
```
|
