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

# Gns3util cluster control object store create bucket

## gns3util cluster-control object-store create-bucket

Create a new bucket in the filestore

### Synopsis

Create a new bucket in the cluster filestore.

The authenticated user becomes the bucket owner automatically. Only the owner
can delete the bucket. Use --public to make the bucket readable without a token,
and --required-scopes to gate access to a specific JWT scope string.

Requires ACTION\_WRITE:RESOURCE\_FILES scope on the cluster.

```
gns3util cluster-control object-store create-bucket <name> [flags]
```

### Examples

```
  gns3util ctl object-store create-bucket my-bucket -c mycluster
  gns3util ctl obj create-bucket shared --public -c mycluster
  gns3util ctl obj create-bucket private --required-scopes "write:files" -c mycluster
```

### Options

```
      --filestore-id string      Specific filestore node ID (optional when only one filestore exists)
  -h, --help                     help for create-bucket
      --public                   Make the bucket publicly readable without a token
      --required-scopes string   JWT scope string required to access files in this bucket
```

### Options inherited from parent commands

```
  -c, --cluster string      Cluster name from keyfile. Mutually exclusive with --server
  -i, --insecure            Ignore unsigned SSL-Certificates. Can be set via GNS3_INSECURE
  -k, --key-file string     Path to authentication keyfile. Can be set via GNS3_KEY_FILE or config.toml
  -o, --output string       Output format: [json, json-colorless, collapsed, yaml, toml, table, table-ascii]. Can be set via GNS3_OUTPUT (default "table")
  -s, --server string       GNS3v3 Server URL. Can be set via GNS3_SERVER or config.toml
      --user string[="~"]   User to select from the keyfile. Omit the value to open a fuzzy picker (--user), or pass a name (--user alice).
```

### SEE ALSO

* [gns3util cluster-control object-store](gns3util_cluster-control_object-store.md)	 - Commands to interact with the gns3util cluster object storage

###### Auto generated by spf13/cobra on 9-May-2026