Create a Custom Global Environment

JFrog Platform Administration Documentation

Content Type
Administration / Platform

Creating a custom global environment enables the users of all projects to perform actions on the repositories assigned to that environment, as defined by their roles. To create a custom global environment, you must be a Platform Admin, as described in Setting Environments and Actions for Global Roles.


By default, Artifactory supports up to 10 global 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.

    JFrog Platform New Navigation

    If you use the new navigation, click Administration on the taskbar, then select Environment. For more information on the new navigation, see JFrog Platform Navigation

  2. From the dropdown list at the top of the window, select All.

  3. Click Create New Environment.

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


    Starting with versions 7.68.6 for Cloud and 7.68.7 for Self-Hosted, you can reorder global 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 Global Environment using a REST API

To create a global environment using a REST API, see Create Global Environment.Create Global Environment