Backup content to your S3 bucket

You can configure manual or automatic daily 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 and click on the Backup tab {2}, add your S3-bucket name.

app.storyblok.com
Storyblok backup app settings
1
2

Storyblok backup app settings

app.storyblok.com
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}.

app.storyblok.com
Storyblok editing capabilities
1
2
  • 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.

Getting Amazon ARN from stack

Getting Amazon ARN from stack

  • 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 you can click "Show latest backups" to show the last 5 backups, choose one of them and click "Restore Now".

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

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