Cloud: Backup And Restore

Each database you create using a RavenDB cloud product, is assigned a mandatory-backup task that stores a full backup every 24 hours and an incremental backup every 1 hour with all the changes that took place since the last backup.

The Backup Task

To view or activate the mandatory backup task, open your product's management studio and -

• Choose the database whose backup task you want to view
• Click Manage Ongoing Tasks
• Click the "Server Wide Backup" task.

Mandatory-Backup Storage

Backups created by the mandatory backup routine are stored in a RavenDB cloud you have no direct access to.
You can view and restore them using your portal's Backups tab and the management Studio.

Custom-Backup Storage

Custom-backup files can be kept using an Amazon service (S3 or S3 Glacier) or a Microsoft service (Azure).
We recommend that you use a backup method local to your host cloud. If your product is hosted by Amazon AWS for example, you can store your backup files on an Amazon S3 bucket.

Mandatory-Backup charge

Mandatory-backup files are kept in RavenDB's own cloud.

We give backup storage of up to 1 GB per product per month for free.

Your backup storage usage is measured once a day, and you'll be charged each month based on your average daily usage.

Free-tier users that overuse backup storage may trim their database to fit the limitation, pay for the extra storage, or stop the product.

Custom-Backup charge

Your custom backups are kept in a storage location of your choosing, and charges for it are unrelated to RavenDB Cloud.

Make sure, however, that you're aware of all possible expenses related to your backups, including -

• Any external storage service you may be charged for (e.g. an S3 bucket)
• File transfer costs you may be charged for (especially if you are backing up outside the region / cloud you are using).

Your mandatory backup files are encrypted.

• If your database is encrypted:
  Your own database encryption key will be used to encrypt the backup as well.

  Be aware that RavenDB Cloud does NOT keep or manage your own database encryption keys.
  If you lose a database encryption key we will NOT be able to help you decrypt the database itself nor its backup files.
  KEEP YOUR ENCRYPTION KEYS SAFE!
  

• If your database is not encrypted:
  We will encrypt its backup files using an encryption key that we manage and is unique to your account.

You can create your own ongoing backup tasks on your RavenDB cloud instance, as you would off-cloud.

Use your cloud instance's management Studio to create a new task.

Add a Backup task

You can store custom-backup files on an unrelated cloud service like an S3 bucket, a Glacier vault, or an Azure platform.

Activate and configure your unrelated cloud storage service, e.g. the bucket in which your backup files would be kept.

View The mandatory Backups List

Backup files that have already been created, are listed in the backups tab.

• Open your portal's Backups tab, and choose the product whose database you want to restore.
  Its backups will be shown, listed by the databases they've been created for.
• Click "Generate Backup Link" for the database you want to restore.
  The backup link window will open.

Restore the Database

Clicking the Generate Backup Link button will show you a simple procedure. Follow it to restore your database.

• A. Create a New Database From Backup
  
• B. Choose Cloud as your Source
  
• C. Copy the Backup Link you've been given in the Backups Tab, to the Backup Link box here.
  
• D. Choose a Restore Point
  
• E. Encryption Key for an Encrypted Database
  If your original database is encrypted, its backup has been encrypted with the same key. Find it and paste it here.
  
• F. Encryption Key for an Unencrypted Database
  If your original database is not encrypted, we used your account-wide encryption key to encrypt your backup file.
  Copy it from the right Backups Tab box.