---
metadata:
  - name: generator
    content: Diplodoc Platform v5.59.0
alternate:
  - https://ydb-platform--ydb.viewer.diplodoc.com/en/reference/configuration/system_tablet_backup_config.md
  - https://ydb-platform--ydb.viewer.diplodoc.com/ru/reference/configuration/system_tablet_backup_config.md
  - href: https://ydb-platform--ydb.viewer.diplodoc.com/en/reference/configuration/system_tablet_backup_config.md
    type: text/markdown
    title: Markdown version
  - href: https://ydb-platform--ydb.viewer.diplodoc.com/en/llms.txt
    rel: describedby
sourcePath: en/core/reference/configuration/system_tablet_backup_config.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb-platform--ydb.viewer.diplodoc.com/en/llms.txt

# system_tablet_backup_config

The [system tablet backup](https://ydb-platform--ydb.viewer.diplodoc.com/en/concepts/backup.md#system-tablet-backup) mechanism provides incremental copying of cluster metadata — such as [Hive](https://ydb-platform--ydb.viewer.diplodoc.com/en/concepts/glossary.md#hive), [BSController](https://ydb-platform--ydb.viewer.diplodoc.com/en/concepts/glossary.md#ds-controller), and [SchemeShard](https://ydb-platform--ydb.viewer.diplodoc.com/en/concepts/glossary.md#scheme-shard) — to the local file system of cluster hosts. The backup behavior is configured in the `system_tablet_backup_config` section of the YDB configuration.

## Syntax


```yaml
system_tablet_backup_config:
    filesystem:
        path: "/path/to/backup/directory"
    exclude_tablet_ids:
        - 72057594037968897
    max_backups_limit: 3
```


## Parameters

| Parameter | Default value | Description |
| --- | --- | --- |
| `filesystem.path` | — | Absolute path to a directory on the host's local file system for storing backups. The directory must be writable by the YDB process on each host where system tablets run. Only local file systems are supported; network file systems such as NFS are not supported. |
| `exclude_tablet_ids` | — | List of system tablet identifiers to exclude from backup, for example, to reduce disk load or save space. |
| `max_backups_limit` | `3` | Maximum number of backups of a single tablet stored on the host. After a new copy is successfully created, the oldest one is automatically deleted when the limit is exceeded. |