---
title: "group create"
slug: "group-create"
updated: 2026-10-27T17:24:31Z
published: 2026-10-27T17:24:31Z
canonical: "docs.vastdata.com/group-create"
---

> ## 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.

# group create

This command creates a group on the local provider.

##### Usage

```plaintext
group add --name NAME
          --gid GID
         [--identity-policies IDs]
         [--local-provider-id ID]
```

## Required Parameters

| `--name NAME` | Sets the group's name. |
| --- | --- |
| `--gid GID` | Specifies the group's POSIX (NFS) GID attribute. |

## Options

| `--local-provider-id ID` | Specifies a local provider with which the group is associated. |
| --- | --- |
| `--identity-policy-ids` | Specifies identity policies with which the group is associated, as a comma-separated list. |

## Examples

```plaintext
vcli: admin> group create --name mygroup --gid 1000 --local-provider-id 1
```