Files
landing_page/qdrant-landing/content/documentation/cloud/backups.md
T

103 lines
4.5 KiB
Markdown

---
title: Backup Clusters
short_description: "Schedule automatic snapshots and restore Qdrant Cloud clusters for disaster recovery, with retention controls and point-in-time recovery."
description: "Set up scheduled snapshots, on-demand backups, and one-click restores for Qdrant Cloud clusters to protect against data loss and enable disaster recovery."
weight: 40
---
# Backing up Qdrant Cloud Clusters
Qdrant organizes cloud instances as clusters. On occasion, you may need to
restore your cluster because of application or system failure.
You may already have a source of truth for your data in a regular database. If you
have a problem, you could reindex the data into your Qdrant vector search cluster.
However, this process can take time. For high availability critical projects we
recommend replication. It guarantees the proper cluster functionality as long as
at least one replica is running.
For other use-cases such as disaster recovery, you can set up automatic or
self-service backups.
## Prerequisites
You can back up your Qdrant clusters though the Qdrant Cloud
Dashboard at https://cloud.qdrant.io. This section assumes that you've already
set up your cluster, as described in the following sections:
- [Create a cluster](/documentation/cloud/create-cluster/)
- Set up [Authentication](/documentation/cloud/authentication/)
- Configure one or more [Collections](/documentation/manage-data/collections/)
## Automatic Backups
You can set up automatic backups of your clusters with our Cloud UI. With the
procedures listed in this page, you can set up
snapshots on a daily/weekly/monthly basis. You can keep as many snapshots as you
need. You can restore a cluster from the snapshot of your choice.
> Note: When you restore a snapshot, consider the following:
> - The affected cluster is not available while a snapshot is being restored.
> - If you changed the cluster setup after the copy was created, the cluster
resets to the previous configuration.
> - The previous configuration includes:
> - CPU
> - Memory
> - Node count
> - Qdrant version
### Configure a Backup
After you have taken the prerequisite steps, you can configure a backup with the
[Qdrant Cloud Dashboard](https://cloud.qdrant.io). To do so, take these steps:
1. On the **Cluster Detail Page** and select the **Backups** tab.
1. Now you can set up a backup schedule.
The **Days of Retention** is the number of days after a backup snapshot is
deleted.
1. Alternatively, you can select **Backup now** to take an immediate snapshot.
![Configure a cluster backup](/documentation/cloud/backup-schedule.png)
### Restore a Backup
You can manage backups from the list of **Available Backups**. You can choose to restore or delete the backups of your choice.
Backups can be restored into the same cluster. This will revert the configuration, including the cluster version, back to the state when the backup was taken.
Or you can restore the backup into a new cluster.
![Restore or delete a cluster backup](/documentation/cloud/restore-delete.png)
## Backups With a Snapshot
Qdrant also offers a snapshot API which allows you to create a snapshot
of a specific collection or your entire cluster. For more information, see our
[snapshot documentation](/documentation/snapshots/).
Here is how you can take a snapshot and recover a collection:
1. Take a snapshot:
- For a single node cluster, call the snapshot endpoint on the exposed URL.
- For a multi node cluster call a snapshot on each node of the collection.
Specifically, prepend `node-{num}-` to your cluster URL.
Then call the [snapshot endpoint](/documentation/snapshots/#create-snapshot) on the individual hosts. Start with node 0.
- In the response, you'll see the name of the snapshot.
2. Delete and recreate the collection.
3. Recover the snapshot:
- Call the [recover endpoint](/documentation/snapshots/#recover-in-cluster-deployment). Set a location which points to the snapshot file (`file:///qdrant/snapshots/{collection_name}/{snapshot_file_name}`) for each host.
## Backup Considerations
Backups are incremental for AWS and GCP clusters. For example, if you have two backups, backup number 2
contains only the data that changed since backup number 1. This reduces the
total cost of your backups.
For Azure clusters, backups are based on total disk usage. The cost is calculated
as half of the disk usage when the backup was taken.
You can create multiple backup schedules.
When you restore a snapshot, any changes made after the date of the snapshot
are lost.