Creating a Project

JFrog Platform Administration Documentation



From JFrog Artifactory 7.17.4, the Projects feature is supported in the JFrog Platform. In the UI, a Project dropdown is added to the taskbar, and a dedicated Projects entity is displayed in the Administration module, serving as the main Projects dashboard for creating and managing your Projects.

Upgrading to Artifactory 7.17.4 with Projects

The process of creating Projects is identical for new and existing users. Resources including repositories, builds and Pipelines and permission target remain intact after the upgrade.

WebUI Changes implemented in Artifactory 7.38.x and above

Identity and Access is now called User Management. All the relevant text and images on this page have been updated to reflect this change.

New Project Workflow

The workflow for creating a new Project includes these main steps.

  1. Set Up a New Project

    The Platform Administrator first creates and configures the basic Project settings, including the Project name and Project Key, assigns Project Admins, and grants Project Admins privileges allowing them to manage Platform resources and Project members.

    Platform Admins can assign repositories to the projects in this initial stage.

    The Platform Administrator is granted all permissions in all projects.

    Setting a Storage Quota

    As part of setting up a project, Platform Admins can set a quota size for the total size of the repositories allocated for the project.

  2. Assign Members to a Project

    Project Admins can then proceed to grant Platform Users and Groups access to the project as Project Members by granting them Global or Project-level roles.

  3. Add or Assign Resources to a Project

    Project Admins can assign existing Repositories or Pipelines Sources from the other projects to a project and/or create new repositories as part of the project.

Distribution in Projects

Because Distribution is not currently included in JFrog Projects, Distribution will, therefore, work with all projects, so that all workflows assume that they are seeing all projects.

Step 1: Setting Up a New Project

Required Permissions

To create a new Project, you need to be assigned the 'Administer the Platform' role.

  1. From the Projects list in the taskbar, select All.

    You are automatically routed to the Projects page in the Administration module that serves as the main dashboard view for all of the projects.

  2. Click + Create New.

    The Create New Project dialog opens.

  3. In the Create New Project dialog, set the following fields:

    1. Type a user-defined Project Name.

    2. Enter the Project Key, a unique key used to identify your Project resources. The Projects Key is added as a prefix to resources created within the Project. This field is mandatory, supports 2 to 32 lowercase alphanumeric characters, and must start with a letter. For example: r1fact.

    3. Enter a description to help other users to understand the scope of your project.

    4. (Optional) Limit the storage quota in GB for the Project.

      Select the Deploy Beyond Limit field, to set the the Storage Quota for monitoring purposes only.

      As part of setting up a Project, Platform Admins can set a quota size for the total size of repositories that can included in the Project. The Project storage quotaappliesto the total virtual size of repositoriesthat are assignedto the project. Project members will not be able to deploy the artifacts if the storage quota is exceeded. There willbe a status warningmessage when reaching 75% of the storage quota. An error is generated when reaching 100% of the storage quota.

    5. Delegate the relevant privileges to the Project Admin. By default, your Project Admins are granted permission to Manage Resources and/or Manage Members. You can leave it as is or disable this option. You can grant Project Admins additional Xray security privileges, such as:

      • Index Resources: Allows a Project Admin to manually select the repositories, builds and release bundles to be indexed. For more information, see Indexing ResourcesConfiguring Xray

    6. Assign Project Admins to the Project by selecting Platform Users and Groups and assigning them the Project Admins role.

      Platform Administrators are tagged in Projects

      Users or Groups assigned with the 'Administer Platform' role are tagged as admin icon.png in the Project Admins list.

    7. Click Create.

      Project Admins assigned to the Project can now proceed to assign Project members and resources to the Project. If granted Xray privileges, Project Admins can proceed to create Watches and Policies and index resources to be scanned by Xray.

    8. (Optional Shortcut for Platform Admins) Assign repositories to the project.

      Platform Administrators can assign repositories to the project at this initial stage or click Create and delegate this task to the Project Admins.


Step 2: Assigning Members to a Project


Before assigning Project members to a Project, you will first need to create User and Groups in the Platform, and then assign Project members to a Project in the Administration module | User Management | Users or Groups. For more information, see Users and Groups.

Required Permissions

You need to be assigned the ' Project Admin' role to assign Platform users/groups as Project members in a Project. The 'Administer the Platform' role has this privilege too.

  1. From the Projects list, select the Project to which you are adding users/groups.

    The Projects Overview tab under the Projects Settings module is selected and the Project view is displayed.


    In this procedure, you will be selecting an existing role for the user/group. To create new roles for the Project, see Creating Project Roles.

  2. To add users/groups as Project members, click +Add Members.

  3. From the Select User or Select Grouplist, select a user, and from theAssign Rolelist, select which role to assign to that user.

    Alternate method for Adding Members

    Select the Project add members by accessing User Management | Members and clicking +Add Members.