# FrostFS S3 Lifecycler configuration

This section contains detailed FrostFS S3 Lifecycler component configuration description.

# Structure

| Section      | Description                                     |
|--------------|-------------------------------------------------|
| `logger`     | [Logger configuration](#logger-section)         |
| `pprof`      | [Pprof configuration](#pprof-section)           |
| `prometheus` | [Prometheus configuration](#prometheus-section) |
| `morph`      | [Morph configuration](#morph-section)           |

### Reload on SIGHUP

Some config values can be reloaded on SIGHUP signal.
Such parameters have special mark in tables below.

You can send SIGHUP signal to app using the following command:

```shell
$ kill -s SIGHUP <app_pid>
```

# `logger` section

```yaml
logger:
  level: debug
  destination: stdout
```

| Parameter     | Type     | SIGHUP reload | Default value | Description                                                                          |
|---------------|----------|---------------|---------------|--------------------------------------------------------------------------------------|
| `level`       | `string` | yes           | `info`        | Logging level. Possible values: `debug`, `info`, `warn`, `dpanic`, `panic`, `fatal`. |
| `destination` | `string` | no            | `stdout`      | Destination for logger: `stdout` or `journald`                                       |

# `pprof` section

Contains configuration for the `pprof` profiler.

```yaml
pprof:
  enabled: false
  address: localhost:8077
```

| Parameter | Type     | SIGHUP reload | Default value | Description                                   |
|-----------|----------|---------------|---------------|-----------------------------------------------|
| `enabled` | `bool`   | yes           | `false`       | Flag to enable pprof service.                 |
| `address` | `string` | yes           |               | Address that pprof service listener binds to. |

# `prometheus` section

Contains configuration for the `prometheus` metrics service.

```yaml
prometheus:
  enabled: false
  address: localhost:8078
```

| Parameter | Type     | SIGHUP reload | Default value | Description                                        |
|-----------|----------|---------------|---------------|----------------------------------------------------|
| `enabled` | `bool`   | yes           | `false`       | Flag to enable prometheus service.                 |
| `address` | `string` | yes           |               | Address that prometheus service listener binds to. |

# `morph` section

Contains configuration for the `morph` chain.

```yaml
morph:
  rpc_endpoint:
    - address: wss://rpc1.morph.frostfs.info:40341/ws
      priority: 0
      trusted_ca_list:
        - "/path/to/ca.pem"
      certificate: "/path/to/cert"
      key: "/path/to/key"
    - address: wss://rpc2.morph.frostfs.info:40341/ws
      priority: 2
  reconnect_clients_interval: 30s
  contract:
    netmap: netmap.frostfs
```

| Parameter                      | Type       | SIGHUP reload | Default value    | Description                                                                                             |
|--------------------------------|------------|---------------|------------------|---------------------------------------------------------------------------------------------------------|
| `rpc_endpoint.address`         | `string`   | no            |                  | The address of the RPC host to connect.                                                                 |
| `rpc_endpoint.priority`        | `int`      | no            |                  | Priority of RPC endpoint.                                                                               |
| `rpc_endpoint.trusted_ca_list` | `[]string` | no            |                  | List of paths to CAs to use in mTLS configuration.                                                      |
| `rpc_endpoint.certificate`     | `string`   | no            |                  | Path to certificate to use in mTLS configuration.                                                       |
| `rpc_endpoint.key`             | `string`   | no            |                  | Path to key to use in mTLS configuration.                                                               |
| `reconnect_clients_interval`   | `string`   | no            | `30s`            | When all endpoints are failed. Overall connection be reinitialized. This value is time between retries. |
| `contract.netmap`              | `string`   | no            | `netmap.frostfs` | Netmap contract hash (LE) or name in NNS.                                                               |