# 2. CMDB (Configuration Management Database)

The CMDB module provides a centralized view of configuration items (instances) grouped by project. It allows teams to manage, search, and organize technical targets and environments that are used across security, CI/CD, and operational workflows.

CMDB is project-aware: all instances are created and viewed within the context of a selected project.

##### Layout Overview

The CMDB screen is divided into two main areas:

**Settings by project**  
Displays a horizontal list of available projects. Selecting a project updates the visible configuration items (instances) below.  
A search field allows quick filtering of projects by name.

**Instances**  
Displays configuration items (targets) associated with the selected project.  
Includes:

1. Search field to find instances by name
2. **+ Add** button to create a new instance
3. Table view for managing existing instances

If no instances exist for the selected project, the system shows **“No data to display.”**

##### Instances Table

Each row in the Instances table represents a configuration item (CI) or target.

**Columns: Target** – Name or identifier of the configuration item  
**Actions** – Edit or manage the instance

The table updates dynamically based on the selected project.

##### Adding an Instance

To create a new configuration item:

1. Select a project from **Settings by project**.
2. In the **Instances** section, click **+ Add**.
3. Enter the required instance details (target name and related configuration).
4. Click **Save**.

The new instance will appear in the table under the selected project.

##### Searching Instances

Use the **Search** field in the Instances section to quickly locate configuration items by name.  
Search is applied only within the currently selected project.

##### Project-Based Scope

1. Instances belong to a single project.
2. Switching projects immediately updates the Instances list.
3. Each project maintains its own isolated CMDB scope.

This ensures clear separation between environments, applications, or customers.