open-vault/website/content/docs/configuration/storage/index.mdx

97 lines
10 KiB
Plaintext
Raw Normal View History

---
layout: docs
page_title: Storage Backends - Configuration
description: |-
2017-11-14 11:13:11 +00:00
The storage stanza configures the storage backend, which represents the
location for the durable storage of Vault's information. Each backend has
pros, cons, advantages, and trade-offs. For example, some backends support
high availability while others provide a more robust backup and restoration
process.
---
2017-11-14 11:13:11 +00:00
# `storage` Stanza
2017-11-14 11:13:11 +00:00
The `storage` stanza configures the storage backend, which represents the
location for the durable storage of Vault's information. Each backend has pros,
cons, advantages, and trade-offs. For example, some backends support high
availability while others provide a more robust backup and restoration process.
For information about a specific backend, choose one from the navigation on the
left.
## Configuration
Storage backend configuration is done through the Vault configuration file using
the `storage` stanza:
```hcl
storage [NAME] {
[PARAMETERS...]
}
```
For example:
```hcl
storage "file" {
path = "/mnt/vault/data"
}
```
For configuration options which also read an environment variable, the
environment variable will take precedence over values in the configuration
file.
Add 'Integrated Storage vs. Consul' comparison (#13999) * Add IS vs. external storage section * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Add a cross-referencing link * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/concepts/storage.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Incorporate review feedback * Incorporate review feedback Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> Co-authored-by: Meggie <meggie@hashicorp.com> Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> Co-authored-by: David Adams <daveadams@gmail.com>
2022-02-11 16:07:35 +00:00
## Integrated Storage vs. External Storage
Add 'Integrated Storage vs. Consul' comparison (#13999) * Add IS vs. external storage section * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Add a cross-referencing link * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/concepts/storage.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Incorporate review feedback * Incorporate review feedback Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> Co-authored-by: Meggie <meggie@hashicorp.com> Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> Co-authored-by: David Adams <daveadams@gmail.com>
2022-02-11 16:07:35 +00:00
HashiCorp recommends using Vault's [integrated
storage](/docs/configuration/storage/raft) for most use cases rather than
configuring another system to store Vault data externally. (Integrated Storage is
Add 'Integrated Storage vs. Consul' comparison (#13999) * Add IS vs. external storage section * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Add a cross-referencing link * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/concepts/storage.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Incorporate review feedback * Incorporate review feedback Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> Co-authored-by: Meggie <meggie@hashicorp.com> Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> Co-authored-by: David Adams <daveadams@gmail.com>
2022-02-11 16:07:35 +00:00
an **embedded Vault data storage** available in Vault 1.4 or later.) Prior to Vault 1.4, Consul was the recommended Vault storage.
-> **NOTE:** [HCP Vault](https://cloud.hashicorp.com/products/vault) clusters
use Integrated Storage as their storage backend.
Add 'Integrated Storage vs. Consul' comparison (#13999) * Add IS vs. external storage section * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Add a cross-referencing link * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/concepts/storage.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Incorporate review feedback * Incorporate review feedback Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> Co-authored-by: Meggie <meggie@hashicorp.com> Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> Co-authored-by: David Adams <daveadams@gmail.com>
2022-02-11 16:07:35 +00:00
The table below compares the characteristics of Integrated Storage and External
Storage. Suppose you decide that the additional operational complexity of external storage is worth it for your use case. In that case, there are several external storage options to choose from (e.g., [Consul](/docs/configuration/storage/consul), [DynamoDB](/docs/configuration/storage/dynamodb), etc.).
Add 'Integrated Storage vs. Consul' comparison (#13999) * Add IS vs. external storage section * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Add a cross-referencing link * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/concepts/storage.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Incorporate review feedback * Incorporate review feedback Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> Co-authored-by: Meggie <meggie@hashicorp.com> Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> Co-authored-by: David Adams <daveadams@gmail.com>
2022-02-11 16:07:35 +00:00
| | Integrated Storage | External Storage |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| HashiCorp Supported | Yes | Limited support |
| Operation | Operationally simpler with no additional software installation required. | Must install and configure the external storage environment outside of Vault. For high availability, the external storage should be clustered. |
| Networking | One less network hop. | Extra network hop between Vault and the external storage system (e.g., Consul cluster). |
| Troubleshooting and monitoring | Integrated Storage is a part of Vault; therefore, Vault is the only system you need to monitor and troubleshoot. | The source of failure could be the external storage; therefore, you need to check the health of both Vault and the external storage. This requires expertise in the chosen storage backend and additional monitoring of that storage. |
Add 'Integrated Storage vs. Consul' comparison (#13999) * Add IS vs. external storage section * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Add a cross-referencing link * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/concepts/storage.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Incorporate review feedback * Incorporate review feedback Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> Co-authored-by: Meggie <meggie@hashicorp.com> Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> Co-authored-by: David Adams <daveadams@gmail.com>
2022-02-11 16:07:35 +00:00
| Data location | The encrypted Vault data is stored on the same host where the Vault server process runs. | The encrypted Vault data is stored where the external storage is located. Therefore, the Vault server and the data storage are hosted on physically separate hosts. |
| System requirements | Avoid "burstable" CPU and storage options. SSDs should be used for the hard drive. <p />See the [Reference Architecture](https://learn.hashicorp.com/tutorials/vault/raft-reference-architecture#system-requirements) guide. | Follow the system requirements given by your chosen storage backend. |
### Integrated Storage vs. Consul as Vault Storage
Add 'Integrated Storage vs. Consul' comparison (#13999) * Add IS vs. external storage section * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Add a cross-referencing link * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/concepts/storage.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Incorporate review feedback * Incorporate review feedback Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> Co-authored-by: Meggie <meggie@hashicorp.com> Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> Co-authored-by: David Adams <daveadams@gmail.com>
2022-02-11 16:07:35 +00:00
[HashiCorp Consul](https://www.consul.io/docs/intro) is a comprehensive
multi-cloud service networking solution including service mesh, service
discovery, and network infrastructure automation. Vault can leverage
Consul's [KV Store](https://www.consul.io/api-docs/kv) to persist Vault data.
The table below highlights the differences between Integrated Storage and
Add 'Integrated Storage vs. Consul' comparison (#13999) * Add IS vs. external storage section * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Add a cross-referencing link * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/concepts/storage.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Incorporate review feedback * Incorporate review feedback Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> Co-authored-by: Meggie <meggie@hashicorp.com> Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> Co-authored-by: David Adams <daveadams@gmail.com>
2022-02-11 16:07:35 +00:00
Consul.
| | Integrated Storage | Consul |
| ------------------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Deployment | Vault cluster is all you need. | Vault cluster & Consul cluster. <p />Use a dedicated Consul cluster for Vault storage, and it should not be used for other purposes (e.g., service discovery, service mesh). <p />See the [Vault with Consul Storage Reference Architecture](https://learn.hashicorp.com/tutorials/vault/reference-architecture#recommended-architecture) guide. |
| Data location | Data is on disk. | All data is in memory. |
| System requirements | [System requirements](https://learn.hashicorp.com/tutorials/vault/raft-reference-architecture#system-requirements) | [System requirements](https://learn.hashicorp.com/tutorials/vault/reference-architecture#hardware-sizing-for-vault-servers) |
| Snapshots | Normal data backup strategy of your organization. | More frequent snapshots are necessary since data is in memory. |
| Max message size | 1 MiB (Configurable using the [`max_entry_size`](/docs/configuration/storage/raft#max_entry_size) parameter) | 512 KiB (Configurable using the [`kv_max_value_size`](https://www.consul.io/docs/agent/options#kv_max_value_size) parameter) |
If you have a Vault cluster using Consul as its storage backend and wish to
migrate to Integrated Storage, read the following tutorials:
Add 'Integrated Storage vs. Consul' comparison (#13999) * Add IS vs. external storage section * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Meggie <meggie@hashicorp.com> * Add a cross-referencing link * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/concepts/storage.mdx Co-authored-by: David Adams <daveadams@gmail.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Update website/content/docs/configuration/storage/index.mdx Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> * Incorporate review feedback * Incorporate review feedback Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com> Co-authored-by: Meggie <meggie@hashicorp.com> Co-authored-by: Lauren Dunnevant <84867887+hashildy@users.noreply.github.com> Co-authored-by: David Adams <daveadams@gmail.com>
2022-02-11 16:07:35 +00:00
1. [Preflight Checklist - Migrating to Integrated
Storage](https://learn.hashicorp.com/tutorials/vault/storage-migration-checklist)
1. [Storage Migration tutorial - Consul to Integrated
Storage](https://learn.hashicorp.com/tutorials/vault/raft-migration)
## Learn
Refer to the [Integrated
Storage](https://learn.hashicorp.com/collections/vault/raft) tutorials
to learn more about Integrated Storage.