mirror of
https://github.com/hashicorp/vault.git
synced 2025-08-22 15:11:07 +02:00
0660ea6fac
* Update README Let contributors know that docs will now be located in UDR * Add comments to each mdx doc Comment has been added to all mdx docs that are not partials * chore: added changelog changelog check failure * wip: removed changelog * Fix content errors * Doc spacing * Update website/content/docs/deploy/kubernetes/vso/helm.mdx Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com> --------- Co-authored-by: jonathanfrappier <92055993+jonathanfrappier@users.noreply.github.com> Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com>
110 lines
4.3 KiB
Plaintext
110 lines
4.3 KiB
Plaintext
---
|
|
layout: docs
|
|
page_title: Manage namespaces
|
|
description: >-
|
|
Learn how to create, delete, and manage namespaces in the Vault GUI.
|
|
---
|
|
|
|
> [!IMPORTANT]
|
|
> **Documentation Update:** Product documentation, which were located in this repository under `/website`, are now located in [`hashicorp/web-unified-docs`](https://github.com/hashicorp/web-unified-docs), colocated with all other product documentation. Contributions to this content should be done in the `web-unified-docs` repo, and not this one. Changes made to `/website` content in this repo will not be reflected on the developer.hashicorp.com website.
|
|
|
|
# Manage namespaces in the Vault GUI
|
|
|
|
@include 'alerts/enterprise-only.mdx'
|
|
|
|
Use namespaces in Vault Enterprise to create isolated environments within a
|
|
single Vault cluster. You can use namespaces to organize teams, projects, or
|
|
environments, and delegate management to different administrators.
|
|
|
|
<Tip title="Best practices for namespaces">
|
|
|
|
For guidance on structuring namespaces, see [Best practices for namespaces and mount paths](/vault/docs/enterprise/namespaces/namespace-structure).
|
|
|
|
</Tip>
|
|
|
|
## Before you start
|
|
|
|
- **You must have Vault Enterprise 1.20.0+.**
|
|
- **You must have permission to create, read, list, delete, and manage namespaces**.
|
|
|
|
## Create a namespace
|
|
|
|
1. In the Vault UI sidebar, navigate to **Access** and select **Namespaces**.
|
|
1. Confirm you have logged in under the correct namespace context. For example,
|
|
to create a top-level namespace, you must be under the `root` namespace.
|
|
1. Click **Create namespace +**.
|
|
1. Enter a unique name for your new namespace.
|
|
1. Click **Save** to create the namespace.
|
|
|
|
|
|
**Create namespace form in the Vault UI**
|
|
|
|
## Create a nested namespace
|
|
|
|
A nested namespace is any namespace that exists within another non-root
|
|
namespace. Vault displays nested namespaces in the GUI with the parent namespace
|
|
as a prefix. For example, a `dev` namespace nested under `engineering` appears
|
|
as `engineering/dev` in the GUI.
|
|
|
|
Before nesting namespaces, we recommend reading the
|
|
[Best practices for namespaces and mount paths](/vault/docs/enterprise/namespaces/namespace-structure)
|
|
guide.
|
|
|
|
1. Create the parent namespace or select an existing namespace from the
|
|
namespace picker or namespace list in the Vault GUI.
|
|
1. Confirm you are in the correct parent namespace context.
|
|
1. Click **Create namespace +**.
|
|
1. On the **Create a Namespace** screen, enter a path for the new, child
|
|
namespace.
|
|
1. Click **Save** to create a namespace nested under the selected parent
|
|
namespace.
|
|
|
|
|
|
## Delete a namespace
|
|
|
|
<Warning title="Namespace deletion is permanent">
|
|
Deleting a namespace removes all resources, secrets, and configuration data
|
|
contained within it. You cannot restore a deleted namespace.
|
|
</Warning>
|
|
|
|
1. Find the namespace you want to delete in the **Namespaces** list.
|
|
1. Delete or move any child namespaces.
|
|
1. Open the the additional options menu by clicking the three dots next to the
|
|
namespace you want to delete.
|
|
1. Select **Delete** from the option menu.
|
|
1. Click **Confirm** on the **Delete this namespace?** confirmation modal.
|
|
|
|
|
|
|
|
|
|
**Delete namespace option in the Vault GUI**
|
|
|
|
## Switch between namespaces from "Manage Namespace"
|
|
|
|
1. Navigate to **Access** > **Namespaces** in the Vault GUI.
|
|
1. Open the additional options button by clicking the three dots next to the
|
|
namespace you want to switch to.
|
|
1. Select **Switch to namespace** from the option menu to change your namespace
|
|
context.
|
|
|
|
|
|
|
|
**Switch to namespace option in the Vault UI**
|
|
|
|
## Switch between namespaces using the namespace picker
|
|
|
|
1. Open the **Namespace picker** dropdown in the Vault GUI to view available
|
|
namespaces.
|
|
1. To filter the namespace list, type part of the namespace path the search bar.
|
|
Vault automatically filters the list of namespaces you can access as you type.
|
|
1. Click on the desired namespace to change your namespace context.
|
|
|
|
<Tip>
|
|
If you know the exact namespace you want, you can type the path directly into
|
|
the namespace picker search bar and press <strong>Enter</strong> to switch your namespace
|
|
context.
|
|
</Tip>
|
|
|
|
|
|
|
|
**Searching for a nested namespace path in the Namespace picker** |