Backups
Backups ensure that your content is safely stored and can be restored. Safeguard your Storyblok data and components by configuring automatic backups to your AWS S3 bucket.
Depending on your pricing plan, you can configure daily or weekly backups.
Included data
- Stories
- Scheduled content
- Releases
- Translated stories
- Translated slugs
- Discussions
- Branches
- Components
- Component groups
- Assets (references only)
- Asset folders
- Roles
- Collaborators
- Workflows and workflow stages
- Workflow stage changes
- Datasources (including dimensions app data)
- App provisions
- Tasks
Backups in Storyblok do not include story versions, presets, space settings, or actual assets. Only asset references are stored. Use the Management API to back up story versions and space settings and the Storyblok CLI for presets. To back up assets, consider creating a script with the Management API or refer to the Storyblok Assets Backup tool for guidance. Restoring a backup will recover assets only if they still exist in Storyblok.
Setup
- 1
Prerequisites
- Create an Amazon AWS account.
- Choose a suitable plan from Storyblok's pricing options.
- 2
Install the app
- Open the Storyblok Apps Directory.
- Install the S3 Backups app.
- 3
Configure backups
- In your space, go to Settings > Backup & Restore > Backup.
- Enter your S3 bucket name and AWS Role ARN.
- Enable automatic backups and schedule them as needed.
- 4
Create an AWS CloudFormation Stack
- Log in to Amazon CloudFormation.
- Create a stack and choose Amazon S3 URL under "Specify template."
- Use this template URL:
https://storyblok-tools.s3.eu-central-1.amazonaws.com/cloudformation/backup.yml
. - Enter your stack name, bucket name, and Storyblok space ID.
- Acknowledge IAM resource creation and create the stack.
- Copy the Role ARN from the stack’s outputs.
- 5
Finalize the backup configuration
- Paste the Role ARN and the S3 bucket name into the AWS ARN field in Storyblok.
- Click Backup Now to test the setup.
Restore a backup
- Go to the Restore tab.
- Select a backup from Path to backup file and click Restore Now.
- Choose to restore specific entries, create a new space, or overwrite the existing space.
- To restore an older backup, manually browse your S3 bucket and paste the backup file path.