---
title: "Backup configuration options"
description: "Server-wide configuration keys that control backup behavior: paths, allowed destinations, concurrency, low-memory delays, and the responsible-node grace period."
url: "https://docs.ravendb.net/7.2/backup/configuration"
version: "7.2"
---

# Backup configuration options

> RavenDB publishes an official agent skill for coding assistants at https://docs.ravendb.net/skills/ravendb/SKILL.md (also installable with `npx skills add ravendb/skills`). The skill describes itself as: "Read this before writing any RavenDB query, client call or /databases/ request. Covers server setup, document modelling, the Node.js, .NET and Python clients, RQL, indexes, vector search and AI agents. Code written from recall tends to run and return the wrong rows, because RQL resembles SQL and the clients take field names as plain strings."

## Backup configuration options

> **Note**
>
> Use the configuration keys listed below to set backup-related options for your RavenDB server.  
> Learn how to apply these keys in the [Configuration Overview](https://docs.ravendb.net/7.2/server/configuration/configuration-options.md) article.
>
> - In this article:
>   - [Backup.TempPath](#backuptemppath)
>   - [Backup.LocalRootPath](#backuplocalrootpath)
>   - [Backup.AllowedDestinations](#backupalloweddestinations)
>   - [Backup.AllowedAwsRegions](#backupallowedawsregions)
>   - [Backup.MaxNumberOfConcurrentBackups](#backupmaxnumberofconcurrentbackups)
>   - [Backup.ConcurrentBackupsDelayInSec](#backupconcurrentbackupsdelayinsec)
>   - [Backup.LowMemoryBackupDelayInMin](#backuplowmemorybackupdelayinmin)
>   - [Backup.MoveToNewResponsibleNodeGracePeriodInMin](#backupmovetonewresponsiblenodegraceperiodinmin)
>   - [Server.CpuCredits.ExhaustionBackupDelayInMin](#servercpucreditsexhaustionbackupdelayinmin)

## Configuration keys {#configuration-keys}

### Backup.TempPath

Use this key to specify the local path where temporary backup files are stored.

> **Info**
>
> - By default, temporary backup files are stored under the server Database directory (or under [Storage.TempPath](https://docs.ravendb.net/7.2/server/configuration/storage-configuration.md) if set).
> - If `Backup.TempPath` is set, temporary backup files will be stored under the path it specifies.
> - If a backup task is configured to store backups in a local folder, `Backup.TempPath` will be ignored and temporary files will be stored alongside the backups.
> - `Backup.TempPath` is also used when restoring a [snapshot](https://docs.ravendb.net/7.2/backup/overview.md#snapshot-image)
>   from a remote destination (Amazon S3, Azure Blob Storage, or Google Cloud Storage):
>   the snapshot file is first downloaded to `Backup.TempPath` and then read from there.  
>   [Logical backups](https://docs.ravendb.net/7.2/backup/overview.md#logical-backup) are streamed directly from
>   the destination and do not use this path.
>
>   [Learn about restoring from a remote destination.](https://docs.ravendb.net/7.2/backup/restore.md#restorebackupconfiguration---backup-location-settings)

- **Type**: `string`
- **Default**: `null`
- **Scope**: Server-wide or per database

### Backup.LocalRootPath

Use this key to set a root path for local backups.  
When set, backup tasks are restricted to storing backups under this path. An attempt to store backups outside it will fail with an exception.

- **Type**: `string`
- **Default**: `null`
- **Scope**: Server-wide only

### Backup.AllowedDestinations

Semicolon-separated list of allowed backup destinations.  
If not specified, all destinations are allowed.

e.g.,

```json
"Backup.AllowedDestinations": "Local;Azure;FTP"
```

- **Type**: `string`
- **Default**: `null`
- **Scope**: Server-wide only

Possible values:

- `None`
- `Local`
- `Azure`
- `AmazonGlacier`
- `AmazonS3`
- `GoogleCloud`
- `FTP`

### Backup.AllowedAwsRegions

Semicolon-separated list of allowed AWS regions.  
If not specified, all regions are allowed.

e.g.,

```json
"Backup.AllowedAwsRegions": "US_EAST_1;US_WEST_2"
```

- **Type**: `string`
- **Default**: `null`
- **Scope**: Server-wide only

### Backup.MaxNumberOfConcurrentBackups

Maximum number of concurrent backup tasks.

- **Type**: `int`
- **Default**: `null`  
  By default, the maximum number of concurrent backup tasks is half the number of CPU cores assigned to the node, rounded down, with a minimum of 1.  
  For example:  
  A server with 1, 2, or 3 CPU cores can run 1 backup operation at a time,  
  A server with 4 or 5 cores can run 2 backup operations at a time,  
  A server with 6 or 7 cores can run 3 backup operations at a time.
- **Scope**: Server-wide only

### Backup.ConcurrentBackupsDelayInSec

Number of seconds to delay the backup when the [concurrent backups limit](#backupmaxnumberofconcurrentbackups) is reached.

- **Type**: `TimeSetting`
- **TimeUnit**: `TimeUnit.Seconds`
- **Default**: `30`
- **Scope**: Server-wide only

### Backup.LowMemoryBackupDelayInMin

Number of minutes to delay the backup if the server enters a low-memory state.

- **Type**: `TimeSetting`
- **TimeUnit**: `TimeUnit.Minutes`
- **Default**: `10`
- **Scope**: Server-wide only

### Backup.MoveToNewResponsibleNodeGracePeriodInMin

Number of minutes the [cluster observer](https://docs.ravendb.net/7.2/server/clustering/distribution/cluster-observer.md) waits
before reassigning a backup task to a new responsible node,
when the current responsible node has entered the
[Rehab state](https://docs.ravendb.net/7.2/server/clustering/distribution/distributed-database.md#database-topology).

During this grace period, the task remains assigned to its current responsible node.  
This gives the node a chance to recover, and prevents a duplicate backup
from starting elsewhere in the cluster.

- **Type**: `TimeSetting`
- **TimeUnit**: `TimeUnit.Minutes`
- **Default**: `30`
- **Scope**: Server-wide only

### Server.CpuCredits.ExhaustionBackupDelayInMin

EXPERT: When CPU credits are exhausted, backup tasks are cancelled.  
This key determines how many minutes the server will wait before retrying the backup task.

- **Type**: `TimeSetting`
- **TimeUnit**: `TimeUnit.Minutes`
- **Default**: `10`
- **Scope**: Server-wide only

> **Info**
>
> If you have an enterprise license, you can access information about CPU credits using [SNMP](https://docs.ravendb.net/7.2/monitoring/integrations/snmp/overview.md).
