Onboard Projects in an Upgraded Environment

JFrog Platform Administration Documentation


WebUI Changes implemented in Artifactory 7.38.x and above

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

From Artifactory 7.17.4, Projects is enabled by default in the JFrog Platform for Enterprise and Enterprise+ users. The upgraded resources - packages, builds and Pipelines are saved under the 'Unassigned' tab and not yet allocated to specific projects. The resources in the Application module - packages, builds, Release Bundles, and Pipelines are displayed according to the predefined permission targets set prior to the upgrade.

Xray version 3.21.2 is now supported in Projects. When upgrading to Artifactory 7.17.4 and Xray 3.21.2, all Xray-related UI entities will appear in the scope of Projects. All previously created Watches and Policies will appear in the Watches & Policies page as Global Watches and Global Policies meaning they are not assigned to a project. To create a Project Watch and Project Policy, you will have to create them in the project scope. To learn more about Xray in Projects, see Projects Concepts and Terminology.

To onboard your existing users or group and resources into projects, do the following:

  1. Set up a new Project.

  2. Assign Platform users and groups with Roles in the Project.

  3. Assign your existing repositories to the Project.

  4. Remove the current permission targets from your reassigned resources.

    1. Navigate to User Management | Permissions and click the required Permission Target in the Permission Target Name column.

    2. In the Edit Permissions Target page, modify the resource assignment in the Repositories tab. For more information, see Permissions.

  5. Assign your resources to the relevant Project.

    1. Click Go to unassigned repositories.


      From the Administration module, under Repositories | Repositories, select a repository and select a Project from the Projects list.