Required Permissions
To create a new Project, you need to be assigned the Platform Administrator role.
From the Projects drop-down menu in the taskbar, select All Projects.
The Projects page serves as the main dashboard view for all of the projects.
Click + Create New.
The Create New Project dialog opens.
In the Create New Project dialog, set the following fields:
In Project Name, enter a name.
In Project Key, enter a unique key used to identify your Project resources. The Project 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.Enter a description to help other users understand the scope of your project.
(Optional) Limit the storage quota in GB for the Project.
Select the Deploy Beyond Limit field to set 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 be 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.
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 Resources.
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 to the Platform Administrator role are tagged as
in the Project Admins list.(Optional for Platform Admins) in the Assign Repositories tab, select 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.
(Optional for Enterprise+ licenses) In the Add Destinations tab, you can add distribution targets (for example, Edge nodes) to which you can distribute Release Bundles from the project. For more information, see:
For Release Bundles v1, see Distribute Release Bundles (v1)
For Release Bundles v2, see Distribute Release Bundles (v2)
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.