> ## 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.

# Configuration Management Projects

> Configuration Management type projects are available within FlexDeploy for managing migrations through FlexDeploy packages and releases. This provides

Configuration Management type projects are available within FlexDeploy for managing migrations through FlexDeploy packages and releases. This provides the ability to orchestrate migrations from FlexDeploy with any approvals, scheduling, and other release tasks defined in one place.

## Initial Setup

#### Create the Project

To start running migrations from a FlexDeploy project, create a package-based project of type Configuration Management.

![image-20260710-194525.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12653887515.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=4e72f8220b62d20582423d8b82e61ab1)

#### Build and Deploy Workflows

The project will need a build workflow containing the **Build Migration** operation and deploy workflow containing the **Deploy Migration** operation. See [Configuration Management Operations](https://docs.flexagon.com/flexdeploy-11-1-documentation/flexdeploy-users-guide/workflows/appendix-workflow/configuration-management-operations.md) for more information on all available operations.

#### Project Configuration

Add the new workflows within the new project configuration. Set the build and deploy target groups to run against a Localhost endpoint.

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

On the Properties tab, set the associated Configuration Management application for the project. Optionally provide include and exclude paths to limit what plans and migrations to include in the project.

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

#### Topology

Navigate to the target group configured on the project. For each target, set the Configuration Management environment associated to this FlexDeploy environment. This is the environment which will be used as a source when required for initiating requests.

![image-20260710-195859.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12654182440.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=30c85eaca20e070674614690a8918016)

#### File Catalog and Packages

Once the project is configured, select **Discover** on the File Catalog to load all migrations for the selected application. File paths will follow the naming convention /\<Plan name>/\<Migration name>. After initial file discovery, migrations will be auto-discovered on creation and synced if any changes occur.

![image-20260710-200331.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12654018587.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=104dfc9e42369dad4063866fdd0e5bf1)

After discovering, a package will automatically be created for each migration in the File Catalog.

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

From here, these migration packages are ready to be built and deployed, or added to a release.

## Running Configuration Management Operations

Migration packages can be built and deployed at the project level. A build execution will verify plan data is loaded for the migration(s) in the package. A deploy execution will perform the actual migration sourcing from the selected environment. Under execution steps, any requests made in Configuration Management will be shown, along with the status and a link to view more details.

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

Migrations can also be initiated at the release level. Along with the general schedules, approvals, etc, pipelines can include utility and pre-deploy steps for performing Configuration Management operations. For more information, see [Execute All Configuration Utility](https://docs.flexagon.com/flexdeploy-11-1-documentation/flexdeploy-users-guide/pipeline-release-management/pipeline/creating-and-editing-a-pipeline-stage/pipeline-steps/execute-all-configuration-utility.md) and [Pre-Deploy All](https://docs.flexagon.com/flexdeploy-11-1-documentation/flexdeploy-users-guide/pipeline-release-management/pipeline/creating-and-editing-a-pipeline-stage/pipeline-steps/pre-deploy-all-step.md#Example-PreDeploy---Create-Baseline-and-Compare-Plan).

## Security

When executing any Configuration Management operations at the project level, the requester must have permission to perform each corresponding request in Configuration Management. If the requester does not have permission, the request will not go through and the FlexDeploy workflow will fail. Make sure to complete setup in Configuration Management for user permissions.

From release executions, security is not restricted by user. Any checks should be in place through pipeline security, approvals and other pipeline gates.