2018-10-24 14:24:29 +00:00
|
|
|
---
|
2020-09-01 15:14:13 +00:00
|
|
|
layout: commands
|
2020-04-07 18:55:19 +00:00
|
|
|
page_title: 'Commands: ACL Bootstrap'
|
2018-10-24 14:24:29 +00:00
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Consul ACL Bootstrap
|
|
|
|
|
|
|
|
|
|
Command: `consul acl bootstrap`
|
|
|
|
|
|
2022-01-11 13:26:58 +00:00
|
|
|
Corresponding HTTP API Endpoint: [\[PUT\] /v1/acl/bootstrap](/api-docs/acl#bootstrap-acls)
|
2022-01-10 17:40:11 +00:00
|
|
|
|
2018-10-24 14:24:29 +00:00
|
|
|
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
|
2020-09-01 15:14:13 +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
|
|
|
|
2022-01-10 21:44:56 +00:00
|
|
|
The table below shows this command's [required ACLs](/api#authentication). Configuration of
|
|
|
|
|
[blocking queries](/api/features/blocking) and [agent caching](/api/features/caching)
|
|
|
|
|
are not supported from commands, but may be from the corresponding HTTP endpoint.
|
|
|
|
|
|
|
|
|
|
| ACL Required |
|
|
|
|
|
| ------------ |
|
|
|
|
|
| `none` |
|
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
|
|
|
|
|
```
|
