open-vault/website/pages/docs/commands/operator/unseal.mdx
Jeff Escalante 8eed94b072
🌷 Docs Website Maintenance (#8985)
* website maintenance round
* improve docs, revert bug workaround as it was fixed
* boost memory
* remove unnecessary code
2020-05-21 13:18:17 -04:00

64 lines
1.7 KiB
Plaintext

---
layout: docs
page_title: operator unseal - Command
sidebar_title: <code>unseal</code>
description: |-
The "operator unseal" allows the user to provide a portion of the master key
to unseal a Vault server.
---
# operator unseal
The `operator unseal` allows the user to provide a portion of the master key to
unseal a Vault server. Vault starts in a sealed state. It cannot perform
operations until it is unsealed. This command accepts a portion of the master
key (an "unseal key").
The unseal key can be supplied as an argument to the command, but this is
not recommended as the unseal key will be available in your history:
```shell-session
$ vault operator unseal IXyR0OJnSFobekZMMCKCoVEpT7wI6l+USMzE3IcyDyo=
```
Instead, run the command with no arguments and it will prompt for the key:
```shell-session
$ vault operator unseal
Key (will be hidden): IXyR0OJnSFobekZMMCKCoVEpT7wI6l+USMzE3IcyDyo=
```
For more information on sealing and unsealing, please the [seal concepts
page](/docs/concepts/seal).
## Examples
Provide an unseal key:
```shell-session
$ vault operator unseal
Key (will be hidden):
Sealed: false
Key Shares: 1
Key Threshold: 1
Unseal Progress: 0
```
## Usage
The following flags are available in addition to the [standard set of
flags](/docs/commands) included on all commands.
### Output Options
- `-format` `(string: "table")` - Print the output in the given format. Valid
formats are "table", "json", or "yaml". This can also be specified via the
`VAULT_FORMAT` environment variable.
### Command Options
- `-migrate` `(bool: false)` - Indicate that this share is provided with the intent that it is part of a seal migration process.
- `-reset` `(bool: false)` - Discard any previously entered keys to the unseal
process.