> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shiftlabs.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Vault

> Connect HashiCorp Vault for secrets management

Connect your HashiCorp Vault instances to manage secrets through ShiftLabs.

## How to Add a Vault Instance

<Steps>
  <Step title="Open Integrations">
    Go to **Settings → Integrations → Vault** tab.
  </Step>

  <Step title="Click Add Vault">
    Click the **Add Vault** button.
  </Step>

  <Step title="Enter Connection Details">
    * **Name** (required): Display name for this instance
    * **Host** (required): Vault server URL (e.g., `https://vault.example.com`)
    * **Token** (required): Vault token for authentication
    * **Verify SSL**: Enable to validate SSL certificates
    * **Set as Default**: Make this the default Vault instance
  </Step>

  <Step title="Save">
    Click **Create**. Use the health check to verify connectivity.
  </Step>
</Steps>

## How to Edit a Vault Instance

1. Click the edit icon on the instance row
2. Modify the settings
3. Click **Save**

<Tip>
  Leave the token field empty when editing to keep the existing token.
</Tip>

## How to Check Health

Click the **Check** button on any instance to verify connectivity. A healthy status confirms Vault is reachable and the token is valid.

## How to Delete a Vault Instance

1. Click the delete icon on the instance row
2. Confirm the deletion

<Warning>
  Deleting a Vault instance removes the connection. Secrets stored in Vault are not affected.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Health check shows Unhealthy">
    1. Verify the host URL is correct
    2. Check if the Vault token is valid and not expired
    3. Ensure Vault is unsealed and running
    4. If using self-signed certificates, disable SSL verification
  </Accordion>

  <Accordion title="Permission denied errors">
    The token may not have sufficient permissions. Ensure the token's policy allows access to the required paths.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Can I connect multiple Vault instances?">
    Yes. Add as many instances as needed for different environments or purposes.
  </Accordion>

  <Accordion title="What token permissions are required?">
    The token needs read access to secrets engines you want to manage through ShiftLabs.
  </Accordion>
</AccordionGroup>