---
title: Charmhub | Deploy Vault using Charmhub - The Open Operator Collection
description: Deploy the latest version of Vault on any cloud.
url: https://charmhub.io/vault/docs/h-recover-a-vault-cluster-when-raft-quorum-is-lost
---

# Vault

[Vault charmers](https://charmhub.io/publisher/vault-charmers "View all packages from Vault charmers")

* [Vault charmers](https://charmhub.io/publisher/vault-charmers "View all packages from Vault charmers")
* [Security](https://charmhub.io/?filter=security)

Platform:

24.04

23.10

23.04

22.10

22.04

20.04

18.04

2.0/stable 710

```
juju deploy vault --channel 2.0/stable
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

---

#### Relevant links

* [Homepage](https://charmhub.io/vault)

---

#### Contacts

* [Submit a bug](https://github.com/canonical/vault-k8s-operator/issues)

---

Share your thoughts on this charm with the community on discourse.

[Join the discussion](https://discourse.charmhub.io/)

# Recover a Vault Cluster When Raft Quorum is Lost

## [Prerequisites](https://charmhub.io/vault/docs/h-recover-a-vault-cluster-when-raft-quorum-is-lost#p-35943-prerequisites)

1. A Vault cluster that has lost quorum

## [1. Scale the Cluster Down to One Node](https://charmhub.io/vault/docs/h-recover-a-vault-cluster-when-raft-quorum-is-lost#p-35943-h-1-scale-the-cluster-down-to-one-node)

On the machine charm, this means removing all but one unit. Ideally, keep the unit that is the leader, but otherwise choose any healthy unit that is in the blocked “Waiting for vault to finish raft leader elecetion” state.

```
juju remove-unit vault/1 vault/2 vault/3 vault/4
```

You may need to use a combination of `--force` and `--no-wait` to remove units if they are in a bad state.

On the Kubernetes charm, you can scale the deployment down using the scale-applicaiton command.

```
juju scale-application vault-k8s 1
```

## [2. Run the `bootstrap-raft` Action](https://charmhub.io/vault/docs/h-recover-a-vault-cluster-when-raft-quorum-is-lost#p-35943-h-2-run-the-bootstrap-raft-action)

Next, run the `bootstrap-raft` action on the remaining unit. This will re-bootstrap the cluster with a single node.

```
juju run vault/leader bootstrap-raft
```

This should update the status of the unit to “Please unseal Vault”.

## [3. Unseal Vault](https://charmhub.io/vault/docs/h-recover-a-vault-cluster-when-raft-quorum-is-lost#p-35943-h-3-unseal-vault)

If necessary, follow the instructions on how to unseal Vault in the Unseal a sealed unit guide.

## [4. Scale the Cluster Back Up](https://charmhub.io/vault/docs/h-recover-a-vault-cluster-when-raft-quorum-is-lost#p-35943-h-4-scale-the-cluster-back-up)

Once the single unit is unsealed, you can scale the cluster back up to the desired number of units (and unseal if necessary)

On the Machine charm:

```
juju add-unit vault -n 4
```

Or, on the Kubernetes charm:

```
juju scale-application vault-k8s 5
```

---