Create an Artifactory group with jf rt group-create

Create a new users group in Artifactory.

Prerequisites

• JFrog CLI installed and configured: run jf config show to verify an active server is set.
• Admin privileges on the Artifactory instance are required.
• Confirm your server is reachable before running commands.

Synopsis

jf rt group-create <group-name> [options]

Aliases: rt gc

Arguments

This command takes the following argument.

Options

This command supports the following options.

Examples

Create a New Group

To create a new group:

• Run:

jf rt group-create <group-name>

Where:

• <group-name> — name for the new group (see Arguments).

Full example:

jf rt group-create my-team

On success, the command exits with code 0 and produces no output. See Verifying the group was created.

Create a Group with Replace

To create or replace a group:

• Run:

jf rt group-create <group-name> --replace

Full example:

jf rt group-create developers --replace

When to Use

Use jf rt group-create to create a logical grouping of users for access control. Groups simplify permission management — instead of assigning permissions to individual users, assign them to groups and add users to those groups.

Typical access control workflow:

To set up a group and grant repository permissions:

1. Create the group:

jf rt group-create backend-team

2. Add users to the group (see jf rt group-add-users for full options):

jf rt group-add-users backend-team alice,bob,charlie

3. Generate a permission target template interactively, then create it. (jf rt ptt requires an interactive terminal. In CI, write the JSON manually instead.)

jf rt ptt ./backend-permissions.json
jf rt ptc ./backend-permissions.json

jf rt ptt walks you through prompts and writes the template file. If you prefer to write the JSON manually, the minimal schema looks like this:

{
  "name": "backend-permissions",
  "repo": {
    "repositories": "libs-release-local",
    "actions": {
      "groups": {
        "backend-team": ["read", "write", "annotate", "delete", "manage"]
      }
    }
  }
}

Verifying the Group Was Created

The group-create command produces no output on success.

To confirm the group exists:

• Query the groups API:

jf rt curl /api/security/groups/<group-name>

Full example:

jf rt curl /api/security/groups/backend-team

Important Notes

• Requires admin privileges on the Artifactory instance.
• Use --replace to overwrite an existing group with the same name. Without --replace, running group-create against a group name that already exists fails with an error instead of overwriting it.
• Creating a group does not automatically assign any permissions — you need to create a permission target that references the group. See Create and Manage Permissions.

Frequently Asked Questions

Related Topics

• Add Users to a Group with jf rt group-add-users
• Delete an Artifactory Group with jf rt group-delete
• Group Management
• Permission Targets