---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://ydb.tech/docs/en/reference/ydb-cli/commands/configuration/node/init.md
  - https://ydb.tech/docs/ru/reference/ydb-cli/commands/configuration/node/init.md
sourcePath: en/core/reference/ydb-cli/commands/configuration/node/init.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/en/llms.txt

# admin node config init

When deploying a new YDB cluster or adding nodes to an existing one (scaling out), each node requires a directory to store its configuration. The `admin node config init` command creates and prepares this directory by placing a specified configuration file in it or retrieving the configuration from another cluster node (seed node).

General command syntax:

```bash
ydb [global options...] admin node config init [options...]
```

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

View the description of the node configuration initialization command:

```bash
ydb admin node config init --help
```

## Subcommand Parameters {#options}

Name | Description
---|---
`-d`, `--config-dir` | **Required**. Path to the directory for storing the configuration file.
`-f`, `--from-config` | Path to the initial configuration file. Required for initial cluster deployment. Can also be used for scaling out if a file with the current cluster configuration has been delivered to the node beforehand.
`-s`, `--seed-node` | Endpoint of the source node (seed node) from which the configuration will be retrieved. Used for scaling out the cluster.

## Examples {#examples}

Initialize the node's configuration directory using the specified configuration file:

```bash
ydb admin node config init --config-dir /opt/ydb/cfg-dir --from-config config.yaml
```

Initialize the node's configuration by retrieving it from a source node:

```bash
ydb admin node config init --config-dir /opt/ydb/cfg-dir --seed-node <node.ydb.tech>:2135
```

## Usage

After successfully initializing the node's configuration directory, you can start the `ydbd` process on this node by adding the `--config-dir` parameter specifying the path to the directory. From this point on, when the cluster configuration is updated, the system automatically saves the updated config to the specified directory, eliminating the need to manually update the configuration file on the node.

When the node restarts, it automatically loads the current configuration from this directory.