Almost EVERYONE who tried headless systems said they saw benefits. Download the state of CMS now!

O’Reilly Report: Decoupled Applications and Composable Web Architectures - Download Now

Empower your teams & get a 582% ROI: See Storyblok's CMS in action

Skip to main content

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.

Section titled Setup instructions Setup instructions

To set up backups, you will need an Amazon AWS account and be a subscriber of Storyblok's "Business" 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.
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 (you'll find below how to get these).
Storyblok backup app settings
1
2
3

Storyblok backup app settings

  • Sign in to your Amazon Cloud formation and create a stack in your preferred region. Under Prepare template {1}, choose Template is ready, and under Specify template {2}, choose Amazon S3 URL as the template source and copy the following URL as the Amazon template URL {3}: https://storyblok-tools.s3.eu-central-1.amazonaws.com/cloudformation/backup.yml
  • Click Next {4}
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}.
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.
Backing up on Storyblok
1

Backing up on Storyblok

Section titled Restore your backup 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.

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".