Creating Groups

In order to create Fuzzball groups, your user will need organization owner permissions. Groups can be created using either the web UI or the CLI. Follow the instructions corresponding to your preferred method below.

Group names must be unique within your organization and should be descriptive to help team members understand the group’s purpose.

select

Please select either the web UI or CLI tab to see the appropriate instructions for your environment.

web UI

Prerequisites

Before creating groups via the web UI, ensure you have:

Organization owner permissions

Creating a Group

Log into your Fuzzball UI as an organization owner
Click on the Gear icon in the top right of the dashboard header and select Manage organization
Navigate to the Groups section in the left toolbar
Click the Add Group button
In the group creation dialog:
- Enter a name for the new group (e.g., “test-group1”)
- Click + Add
The new group will appear in your groups list and you will be set as the group owner

After creating the group, you can begin adding users and configuring group-specific resources.

CLI

Prerequisites

Organization owner permissions
Fuzzball CLI with a context configured for the admin user

Creating a Group

To create a new group, use the Fuzzball group CLI subcommand create with the desired group name as an argument. In this example, we’ll create an group named test-group1:

$ fuzzball group create test-group1
Group: test-group1 created with id: 324fe14b-1008-4c2d-8e07-e7136c7db38f

When a group is successfully created, a UUID is returned as shown above. This ID uniquely identifies the group and can be used in other CLI operations.

Verifying Group Creation

To confirm the group was created successfully, you can list all groups:

$ fuzzball group list
SELECTED | NAME                         | ID                                   | CREATED TIME          | LAST UPDATED
         | User Account (admin@ciq.com) | 06559942-1f88-4c99-93c5-2dfb1537d355 | 2024-06-19 12:51:29PM | 2024-06-19 12:51:29PM
    *    | default                      | 2ec072f6-7ab2-42fc-acce-5fc0912ce3b0 | 2024-07-03 09:38:14PM | 2024-07-03 09:38:14PM
         | test-group1                  | 324fe14b-1008-4c2d-8e07-e7136c7db38f | 2024-07-09 10:18:18PM | 2024-07-09 10:18:18PM

The new test-group1 group appears in the list, confirming it was created successfully. You are automatically set as the group owner when creating a group via the CLI.

Next Steps

After creating your group, you may want to:

Add users to the group to give them access to group resources
Set up storage volumes, secrets, and other resources for the group