Step 1: Set Up a New Project

JFrog Platform Administration Documentation

Content Type
Administration / Platform

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.

    The Projects page 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 quota applies to the total virtual size of repositories that are assigned to the project. Project members will not be able to deploy the artifacts if the storage quota is exceeded. There will be a status warning message 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 ResourcesIndexing Xray Resources

    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.