Create a backup
Written by
Updated at July 24, 2026
You can create a backup for any ClickHouse® cluster existing in your project.
CLI
**full**: Creates a full cluster backup. The `spec.incrementFrom` field is ignored.
**incremental**: Captures only the changes made since a previous backup. Under `spec.incrementFrom`, make sure to specify the name of the baseline `ClickhouseBackup` resource for the new increment, e.g., name of a full backup or the most recent increment.
Create the `ClickhouseBackup` resource file, e.g., using the `touch clickhousebackup.yaml` command.
Open the file and paste the configuration:
Apply the manifest: `kubectl apply -f clickhousebackup.yaml -n <project_name>`. Optionally, you can specify the project name in the `metadata.namespace` resource property and skip it in the command.
Management console
spec.type supports two backup strategies:
Optionally, under spec.shards, list shards for the backup, where each item is an object with a name field containing the cluster shard ID. If not specified, the backup captures all shards in the cluster.
apiVersion: clickhouse.stackland.yandex.cloud/v1alpha1
kind: ClickhouseBackup
metadata:
labels:
app.kubernetes.io/name: ch-stackland-operator
app.kubernetes.io/managed-by: kustomize
name: backup
spec:
cluster:
name: ch-sample-mine
type: full
shards:
- name: "shard-1"
- If you have not opened a project yet, select one.
- In the left-hand menu, select ClickHouse® Clusters.
- Select a cluster.
- Click Create backup.
- Confirm the creation of a backup.
This is it, your backup has been created.
Note
To recover a deleted cluster from a backup, see Recovering a cluster.