This tutorial provides steps to properly enable automatic file backups on your Cloudinary account. For further details about Cloudinary's backup capabilities, we recommend reviewing our documentation sections on backups and revisions.
- Watch a Video
- Understanding the Purpose of Automatic Backups
- Enabling Automatic Backups via the Cloudinary Management Console
- Using Amazon S3 or Google Cloud Storage for Backups
- Testing Your Enabled Backup Processes
- Additional Resources
Watch a Video
Understanding the Purpose of Automatic Backups
One very useful feature of Cloudinary’s service is its ability to backup your files, such as images and videos. This includes revisions of your existing assets, as well as deleted files that you can restore.
After enabling automatic backup, deleted files remain backed up for 30 days and are then removed. File revisions remain in your backup for an unlimited amount of time. If you are using a secondary storage location, such as an Amazon S3 bucket or Google Cloud Storage, the deleted files and revisions will always live there, as Cloudinary does not touch those assets and cannot remove them.
Cloudinary handles the backup process by copying each original file to a secondary write-protected location. If you have enabled Automatic Backup without setting a designated Amazon or Google bucket, the storage will count against your Cloudinary storage threshold. This has the potential to double your storage. Keep in mind that if you are approaching the top of your plan’s available managed storage, adding backups will likely cause you to exceed the allotted amount. Our Customer Success team is always available for consultation and assistance, if you have any questions or concerns before implementing our backup feature. This feature is also available for all service plans.
If you plan to backup your assets to your own Amazon S3 or Google Cloud Storage buckets instead of Cloudinary’s storage, any of our paid service plans offer that as an option.
In either case, all newly uploaded assets will be automatically backed up after you turn Automatic Backup on for your account.
Enabling Automatic Backups via the Cloudinary Management Console
To set up Cloudinary’s Automatic Backup feature, take the following steps:
- Log into your Cloudinary Management Console.
- Select the Settings icon, which resembles a gear.
- Select the Upload tab.
- At this point, you should able to start setting up the account backups. This can be done by clicking the Automatic Backup drop-down field and choosing Enabled. Then, scroll down to the bottom of the screen and click the Save button.
- Directly under the Automatic Backup drop-down field is a new link labeled Perform initial backup. Select it.
If you have successfully done this, a popup window labeled Initial Backup will appear. Additionally, the email address associated with your account will be added to the window’s Notification email field. Verify or change the address, then select the window’s OK button.
Once you do this, the Perform initial backup link will change to a Successfully initiated backup confirmation message.
- Scroll down to the bottom of the screen and select the Save button.
If you have followed these steps, you should receive an automated email from email@example.com. It will be sent to the address specified in Step #5 of this process.The email will state that the backup has been completed successfully and include details on the total amount of assets that were stored in a specific account.
Using the example screenshot above, 75 assets were backed up for the account/cloud named “sambrace”.
The amount of time for this process to occur will depend on the amount of assets stored in your Cloudinary account, as well as the actual file sizes of those assets. However, you can always send us a support ticket if you do not receive the confirmation email within an hour of taking the proper steps.
Using Amazon S3 or Google Cloud Storage for Backups
On top of Cloudinary’s own write-protected location for backup storage, you can set a designated bucket or secondary location to keep your files. We support backups through Amazon Simple Storage Service (e.g. Amazon S3) and Google Cloud Storage. However, this service is only available for accounts on any paid plan.
Amazon S3 Setup
If you want to backup to your S3 bucket, please proceed with the directions provided by Amazon Web Services.
It is important to follow the proper naming conventions for your S3 bucket. You can find further details about doing so in our Knowledge Base.
Once you have confirmed your S3 bucket is set up and working, please follow the steps outlined in these Knowledge Base articles to link it to your Cloudinary account.
- How do I grant Cloudinary with the permissions to backup on my private S3 bucket?
- How do I allow Cloudinary to read from my private S3 bucket?
Further details on setting bucket and object access permissions in your S3 bucket can be found in Amazon Web Services’ official documentation.
Google Cloud Storage Setup
If you want to backup to your Google Cloud Storage bucket, please proceed with the directions provided by Google.
It is important that your bucket name matches your Cloudinary cloud name, then ends with “-gs-cld”. If you do not know your Cloudinary cloud name, you can find it in your Console Dashboard.
In the screenshot example above, the cloud name is “sambrace”. Therefore, the Google Cloud Storage bucket should be named “sambrace-gs-cld”.
Once you have confirmed your Cloud Storage bucket is set up and working, please follow the steps below to link it to your Cloudinary account.
- Log into your Google Cloud Storage account and select the More Options icon/kebab for your chosen bucket. Then, select the Edit bucket permissions option.
- Add firstname.lastname@example.org as a member with the Storage Object Admin role.
- Follow the steps outlined above to access your Cloudinary Console’s Upload Settings.
- Type the name of your Google Cloud Storage bucket into the Backup S3 bucket field.
- Click the Save button at the bottom of the page to confirm your changes.
Further details on controlling access to Google Cloud Storage buckets and objects using Identity and Access Management (IAM) permissions can be found in Google’s official documentation.
Testing Your Enabled Backup Processes
Once you have properly set up your Automatic Backup feature, your selected asset in the Cloudinary Console should have a new View backed up versions button.
To find this button, follow the steps outlined in our Retrieving Images, Videos and Other Assets from Backup with Cloudinary’s Management Console tutorial.
After enabling Automatic Backup, there are several areas you can newly manage with your Cloudinary account. This includes retrieving backed up versions, as well as restoring previously deleted files. We have full tutorials on these subjects that we recommend reviewing:
- How to Restore Deleted Assets with Cloudinary’s Management Console
- Retrieving Images, Videos and Other Assets from Backup with Cloudinary’s Management Console
Further details about Cloudinary’s backup and revision options, including ways to specify the backup boolean parameter in our Upload API, can be found in our official documentation.
If you have any questions or comments from this tutorial, you can always send those to us as a support request.