Create a Custom Project Environment

JFrog Platform Administration Documentation

Content Type
Administration / Platform

Creating a custom project environment enables the users assigned to that project to perform actions on the resources assigned to that environment, as defined by their roles.


By default, Artifactory supports up to 10 project environments. To change this default value, modify the Access configuration YAML, as described in Supported Access Configurations. The maximum recommended number of environments is 30.Supported Access Configurations

  1. In the Administration tab, go to Environments.

  2. If you are a Platform Admin or the Project Admin of multiple projects, select the name of the relevant project from the dropdown list at the top of the window. (If you are a Project Admin for a single project, you will already be in your project and can skip this step.)

  3. Click Create New Project Environment.

  4. Enter a name for the environment and click Create. The maximum length is 32 characters.


    When creating a project environment, the name of the project is used as the prefix for the environment. Because of the prefix, multiple projects can have environments with the same name.


    Starting with versions 7.68.6 for Cloud and 7.68.7 for Self-Hosted, you can reorder project environments by dragging them to different positions with your mouse.

    The order defined here determines the order of environments shown on the Release Bundle v2 kanban board. For more information, see Use the Release Bundle v2 Promotions Kanban Board.Use the Release Bundle v2 Promotions Kanban Board

  5. Continue with the following procedures, Assign Environments to Global and Project Roles, and Assign Environments to Repositories.

Create a Project Environment using a REST API

To create a project environment using a REST API, see Create Project Environment.Create Project Environment