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

# admin cluster config replace

With the `admin cluster config replace` command, you can upload a [dynamic configuration](https://ydb.tech/docs/en/devops/configuration-management/configuration-v1/dynamic-config.md?version=v25.3) to the YDB cluster.

<!-- source: en/reference/ydb-cli/commands/configuration/_includes/danger-warning.md -->
{% note alert %}

Commands in this section can harm your cluster if used incorrectly. Due to the potentially dangerous nature of these commands, ALL global parameters must be specified explicitly. Profiles are disabled by default and are only used when explicitly specified (--profile <profile-name>). Some commands do not require global options that are otherwise mandatory.

{% endnote %}
<!-- endsource: en/reference/ydb-cli/commands/configuration/_includes/danger-warning.md -->

General command syntax:

```bash
ydb [global options...] admin cluster config replace [options...]
```

* `global options` — Global parameters.
* `options` — [Subcommand parameters](#options).

View the description of the dynamic configuration replacement command:

```bash
ydb admin cluster config replace --help
```

## Subcommand Parameters {#options}

#|
|| Name | Description ||
|| `-f`, `--filename` | Path to the file containing the configuration. ||
|| `--allow-unknown-fields`
| Allow unknown fields in the configuration.

If the flag is not set, unknown fields in the configuration result in an error.
    ||
|| `--ignore-local-validation`
| Ignore basic client-side configuration validation.

If the flag is not set, YDB CLI performs basic client-side configuration validation.
    ||
|#

## Examples {#examples}

Upload the dynamic configuration file to the cluster:

```bash
ydb admin cluster config replace --filename config.yaml
```

Upload the dynamic configuration file to the cluster, ignoring local applicability checks:

```bash
ydb admin cluster config replace -f config.yaml --ignore-local-validation
```

Upload the dynamic configuration file to the cluster, ignoring the check for unknown fields:

```bash
ydb admin cluster config replace -f config.yaml --allow-unknown-fields
```