---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ydb.tech/docs/en/devops/configuration-management/configuration-v1.md?version=v25.4
  - https://ydb.tech/docs/ru/devops/configuration-management/configuration-v1.md?version=v25.4
  - href: en/devops/configuration-management/configuration-v1/index.md
    type: text/markdown
    title: Markdown version
  - href: ../../../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: en/core/devops/configuration-management/configuration-v1/index.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/en/llms.txt

# Configuration V1

This section of the YDB documentation describes Configuration V1, which is the main way to configure YDB clusters deployed using YDB.

Configuration V1 is a two-level YDB cluster configuration system consisting of [static configuration](https://ydb.tech/docs/en/devops/configuration-management/configuration-v1/static-config.md?version=v25.4) and [dynamic configuration](https://ydb.tech/docs/en/devops/configuration-management/configuration-v1/dynamic-config.md?version=v25.4):

1. **Static configuration**: a YAML format file that is located locally on each static node and used when starting the `ydbd server` process. This configuration contains, among other things, [static group](https://ydb.tech/docs/en/concepts/glossary.md?version=v25.4#static-group) and [State Storage](https://ydb.tech/docs/en/concepts/glossary.md?version=v25.4#state-storage) settings.

2. **Dynamic configuration**: a YAML format file that is an extended version of static configuration. It is loaded via [CLI](https://ydb.tech/docs/en/recipes/ydb-cli/index.md?version=v25.4) and reliably stored in the [Console tablet](https://ydb.tech/docs/en/concepts/glossary.md?version=v25.4#console), which then distributes the configuration to all dynamic cluster nodes. Using dynamic configuration is optional.

You can learn more about Configuration V1 in the [Configuration V1 Overview](https://ydb.tech/docs/en/devops/configuration-management/configuration-v1/config-overview.md?version=v25.4) section.

Starting from version v25.1, YDB supports [Configuration V2](https://ydb.tech/docs/en/devops/configuration-management/configuration-v2/index.md?version=v25.4), a unified approach to configuration in a single file format. When using Configuration V2, automatic configuration of [static group](https://ydb.tech/docs/en/concepts/glossary.md?version=v25.4#static-group) and [State Storage](https://ydb.tech/docs/en/concepts/glossary.md?version=v25.4#state-storage) becomes possible. When deploying new clusters on YDB version v25.1 and above, it is recommended to use Configuration V2.

Main materials:

- [Configuration V1 Overview](https://ydb.tech/docs/en/devops/configuration-management/configuration-v1/config-overview.md?version=v25.4)
- [YDB Cluster Configuration](https://ydb.tech/docs/en/devops/configuration-management/configuration-v1/static-config.md?version=v25.4)
- [Dynamic Cluster Configuration](https://ydb.tech/docs/en/devops/configuration-management/configuration-v1/dynamic-config.md?version=v25.4)
- [Volatile Configurations](https://ydb.tech/docs/en/devops/configuration-management/configuration-v1/dynamic-config-volatile-config.md?version=v25.4)
- [Cluster Configuration Domain-Specific Language (DSL)](https://ydb.tech/docs/en/devops/configuration-management/configuration-v1/dynamic-config-selectors.md?version=v25.4)
- [Changing Configurations via CMS](https://ydb.tech/docs/en/devops/configuration-management/configuration-v1/cms.md?version=v25.4)
- [Changing Actor System Configuration](https://ydb.tech/docs/en/devops/configuration-management/configuration-v1/change_actorsystem_configs.md?version=v25.4)
- [Expanding a Cluster](https://ydb.tech/docs/en/devops/configuration-management/configuration-v1/cluster-expansion.md?version=v25.4)
- [State Storage Move](https://ydb.tech/docs/en/devops/configuration-management/configuration-v1/state-storage-move.md?version=v25.4)
- [Static Group Move](https://ydb.tech/docs/en/devops/configuration-management/configuration-v1/static-group-move.md?version=v25.4)
- [Replacing Node FQDN](https://ydb.tech/docs/en/devops/configuration-management/configuration-v1/replacing-nodes.md?version=v25.4)
- [Database Node Authentication and Authorization](https://ydb.tech/docs/en/devops/configuration-management/configuration-v1/node-authorization.md?version=v25.4)