> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexagon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Environments

> What are Environments? An Environment is a logical name given to a group of servers, applications, and technologies which work together to provide a s

# What are Environments?

An **Environment** is a logical name given to a group of servers, applications, and technologies which work together to provide a software solution for the purpose of development, testing, or a production implementation. Typical Environments include, but are not limited to, Development (DEV), System Integration Testing (SIT), User Acceptance Testing (UAT), and Production (PROD).

# Viewing Environments

To view the list of Environments defined within FlexDeploy, select ***Topology*** from the menu, and then choose the ***Environments*** tab.

![image-20250725-152124.png](https://mintcdn.com/flexagon-llc-ce77a95c/s5KJA2KdwTZ5hdNK/images/fd111/12590911275.png?fit=max\&auto=format\&n=s5KJA2KdwTZ5hdNK\&q=85\&s=99d244ca5ec3cfc8b5d898f7660dfb3b)

By default, all active Environments are displayed in the search results. To refine the search results, type all or part of the Environment name into the ***Search*** box, and the list will automatically filter.

Click the ***Inactive*** toggle to show the inactive environments.

![image-20250725-152357.png](https://mintcdn.com/flexagon-llc-ce77a95c/s5KJA2KdwTZ5hdNK/images/fd111/12590911272.png?fit=max\&auto=format\&n=s5KJA2KdwTZ5hdNK\&q=85\&s=781ecd2ecc9f9fae19f6a8555127821d)

# Creating and Editing an Environment

To create an Environment, click the ***Create*** button in the top right. To edit an Environment click on it’s name, or click on the 3 dots of an existing Environment row from the list.

![Image](https://mintcdn.com/flexagon-llc-ce77a95c/s5KJA2KdwTZ5hdNK/images/fd111/12590911290.png?fit=max\&auto=format\&n=s5KJA2KdwTZ5hdNK\&q=85\&s=4fca76e68fac1d5c8fd95ef86762a45f)

Now click on ***Edit*** option to edit the existing environment.

![Image](https://mintcdn.com/flexagon-llc-ce77a95c/YN4KiePcysQpaVpd/images/fd111/12590911281.png?fit=max\&auto=format\&n=YN4KiePcysQpaVpd\&q=85\&s=e9c1046aafb050b1aca53c49ad939468)

Enter values for the following fields.

<table><colgroup><col /><col /><col /></colgroup><tbody><tr><th>**Field Name**</th><th>**Required**</th><th>**Description**</th></tr><tr><td>Code</td><td>Yes</td><td>Short name for the Environment.</td></tr><tr><td>Name</td><td>Yes</td><td>Long display name for the Environment.</td></tr><tr><td>Description</td><td>No</td><td>A description of the Environment.</td></tr><tr><td>Environment Color</td><td>No</td><td>To display specific color to the environment.</td></tr><tr><td>Build Environment</td><td>Yes</td><td>Identifies whether the Environment is used for builds.</td></tr><tr><td>Production Environment</td><td>No</td><td>Whether to use Environment as used for production</td></tr><tr><td>Environment Permissions</td><td>Yes</td><td>You can toggle a slider to override the default permissions. If overriding, you can assign certain groups permission to modify the environment.If users have write access to **both **the target group and environment, then they can modify the target’s properties and endpoints.</td></tr><tr><td>Active</td><td>Yes</td><td>Whether or not the Environment is active in the system. Defaults to "Yes".</td></tr></tbody></table>

Click the ***Save*** button to save the changes to the Environment, or to cancel the changes ***Cancel*** button is to be clicked.

To delete the existing Environment, click on ***Delete*** option.

![Image](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590911287.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=7b31840e58c9a6944f867b081d7d47e3)

# Environment Sort Order

Environments can be ordered in list view using drag icon. This is referenced as Sort Order as main usage is to order environments displayed in drop downs. Order can reflect general promotion path, where Production will be at the bottom of screen. Such ordering is for 2 reasons.

1. Environments in various drop downs are listed as per this order.

2. If workflow execution threads are exhausted, pending executions for environments higher in this sort order will be considered first for execution when threads become available, i.e. preference will be given to environment at the bottom on environments list.

# Environment Tags

To add Tag to the Environment , click on the three dots that we are seeing on right side of the particular Environment row.

![Image](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590911284.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=dff6697cd79d5d7769bd099b1407a086)

After clicking on the Add Tag option, then you can see a list of already created tags , by clicking on a tag from the list of tags such tag will be assigned to selected Environment.

![Image](https://mintcdn.com/flexagon-llc-ce77a95c/YN4KiePcysQpaVpd/images/fd111/12590911278.png?fit=max\&auto=format\&n=YN4KiePcysQpaVpd\&q=85\&s=5ba66c7c170817110962d7ce6d25dd5a)

To Manage the Tags you can navigate to ***Tags*** from the ***menu*** and manage the Tags [Tags | Managing Tags](https://docs.flexagon.com/flexdeploy-9-0-documentation/flexdeploy-users-guide/administration/tags.md#Managing-Tags) .

# Inactivating and Activating Environments

To inactivate an Environment at any time, click the ***Active*** link on the desired Environment, and it will toggle to ***Inactive***. This will hide that Environment after leaving the screen, until the ***Active*** checkbox is unchecked. To reactivate an Environment, click the ***Inactive*** link and it will toggle back to ***Active***. This Environment is now active in the system again and ready for use.