Backup content to your S3 bucket

You can configure manual or automatic daily/weekly (depending on your subscription plan) backups of your content and component definitions in Storyblok with the "Backups" app. This adds additional security and lets you restore the backups created on your personal Amazon AWS S3 bucket.

IMPORTANT:

The backup file contains stories(content), releases, scheduled content, Installed apps, assets, component definitions (schemas), Collaborators, roles and preview templates for your space. It will NOT contain presets, components groups, datasources and space settings.

Setup instructions

To set up backups, you will need an Amazon AWS account and be a subscriber of Storyblok's "Team" or "Enterprise" plan. If you don't have an Amazon AWS account yet, click here to signup.

  • Install the app "S3 Backups" in the Apps Directory section of Storyblok.

app.storyblok.com
Storyblok backups app

Storyblok backups app

  • Go to space settings {1} page, click on the Backup & Restore tab {2}, and click on the Backup tab {3}, add your S3-bucket name and your AWS Role ARN.

app.storyblok.com
Storyblok backup app settings
1
2
3

Storyblok backup app settings

creating a stack with Amazon Cloud formation
1
2
3
4

creating a stack with Amazon Cloud formation

  • Input the stack name, bucket name and Storyblok space ID, it's important to note that this should be in lower case, Click Next and Next.

Specifying stack details on AWS

Specifying stack details on AWS

  • On the review page, click on "I acknowledge that AWS CloudFormation might create IAM resources with custom names." {1} then click on "Create Stack" {2}.

Storyblok editing capabilities
1
2

After creating a stack, you'd see the newly create stack and a role as seen in the image below.

Getting Amazon ARN from stack

Getting Amazon ARN from stack

  • Go to "Outputs" and copy the "Role ARN" field and paste it into the "AWS ARN" field and input the name of the S3 bucket on Storyblok.

  • Click on Backup now {1} to test the backup.

app.storyblok.com
Backing up on Storyblok
1

Backing up on Storyblok

Restore your backup

To restore a backup, select the Restore tab {1}, you can click "Path to backup file" to show the latest backups, choose one of them and click "Restore Now" {2}.

You can choose to restore specific entities, create a new space or overwrite your current space when you restore.

app.storyblok.com
Restoring S3 backups on Storyblok
1
2

Restoring S3 backups on Storyblok

If the backup you want to restore is older, then you can insert the path you get by browsing your S3 bucket manually in the input field "Backup file".