Environments
Learn about environments in Artifactory, how to create and manage global and project environments, and the workflow for environment management including roles and repository assignments.
Important
Artifactory release 7.125.3 (released October 2025) introduces Stages to replace Environments. Support for existing environments continues until further notice. For more information, see Stages & Lifecycle.
Environments are used to aggregate project resources, such as repositories, to simplify their management.
Artifactory contains two default environments - DEV (Development) and PROD (Production), and additional custom environments can be created for specific projects, or for all projects, as needed. Each repository can be assigned to one or more environments, a feature that enables you to allocate repositories in ways that best serve the needs of your organization. Multiple repositories can be assigned to the same environment.
You can create custom environments at the global level, where they are available to users across all projects, or at the project level for the project's members. At the project level, specific roles can be assigned to custom environments, which enable you to implement a more granular permissions model for that project.
Environment Management Workflow
The following workflow illustrates how to create and manage environments.
| Procedure | Using the JFrog Platform UI | Using REST API | |
|---|---|---|---|
| 1 | Create a global environment | Create a Custom Global Environment | Create Global Environment |
| 2 | Create a project environment | Create a Custom Project Environment | Create Project Environment |
| 3 | Edit a global role and assign an environment | Assign Environments to Global and Project Roles | Edit a Global Role |
| 3 | Create a custom global role and assign an environment | Create Custom Global Roles | Create a Custom Global Role |
| 4 | Create a project role and assign an environment | Create Project Roles | Create Role |
| 5 | Assign repositories to each environment | Configuring a Local Repository | Update Repository Configuration Based on changes made in the Repository Configuration JSON. |
| 6 | Delete a custom environment | Delete a Custom Environment | Delete Global Environment |
Updated about 2 months ago