---
title: "Managing Local Groups"
slug: "managing-local-groups"
updated: 2026-10-28T01:54:03Z
published: 2026-10-28T01:54:03Z
canonical: "docs.vastdata.com/managing-local-groups"
---

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

# Managing Local Groups

Groups must be added to the VAST provider in order to be associated with a local user. When creating a group, you specify a group name and a GID. A SID is generated for the group.

When providers are queried for groups, groups that are duplicated on multiple external providers are merged by group name. If the different instances of the same group name have conflicting GIDs or SIDs, the attributes of the local group override those of all other providers.

## Creating a Group in VAST Web UI

1. From the left navigation menu, select User Management and then the Local Groups tab.
2. On the Local Groups page that opens, click Create Group.
3. In the Add Group dialog, complete the fields:

| Field | Description |
| --- | --- |
| Name (required) | Enter a name for the group. |
| GID (required) | Enter a POSIX group ID (GID) for the group. |
| Local Provider (required) | Optionally, select the VAST provider with which the group will be associated. If additional providers are added (in the VAST Providers tab), you can select one of them. |
| Tenant | Select a tenant from the list. Tenants associated with the selected VAST provider (if any) are shown, as well as the default tenant. |
| Identity Policies | Optionally, select one or more [S3 identity policies](/docs-5-4/docs/managing-identity-policies) to assign to the group. If needed, click Add Identity Policy to [create](/docs-5-4/docs/en/creating-identity-policies) a policy first. The list of policies shown are for the selected tenant, if a tenant is associated with the provider.Managing Identity PoliciesCreating Identity Policies |
4. Click Create. The group is created.

## Modifying a Group in VAST Web UI

1. From the left navigation menu, select User Management and then the Local Groups tab.
2. In the Local Groups page, right-click on the group you want to modify, and select Edit.
3. In the Update Group dialog that opens, make the changes you need and click Update.

The group is updated with the changes.

## Removing a Group in VAST Web UI

1. From the left navigation menu, select User Management and then the Local Groups tab.
2. In the Local Groups page, right-click on the group you want to delete, and select Remove.
3. In the confirmation popup, click Yes to confirm. The group is removed from the VAST provider.

## Managing Local Groups in VAST CLI

To manage local groups using the [VAST CLI](/docs-5-4/docs/using-the-vast-cli), use the following commands.

| Task | Command |
| --- | --- |
| Create a group | `group create` |
| List groups | `group list` |
| Modify a group | `group modify` |
| Delete a group | `group delete` |
| Show details of a group | `group show` |
| Query a group | `group query` |
| Query a group by prefix | `group query-by-prefix` |