Skip to main content
Setting Up Amazon S3 Backups
Toshi Dávila avatar
Written by Toshi Dávila
Updated over a week ago

To access your Amazon S3 Backup settings, first open your Assembla space Admin page, and then click on Backup and Data Export. There are 2 different ways to setup Amazon S3 backups.

Note: If backups don't work for you, make sure that your plan includes them. Not every plan will have access to Amazon S3 Backups.

Note: Backups to Amazon S3 will not include data from Perforce depots.

1. AWS Keys

To create an access key for your AWS account root user

1. Use your AWS account email address and password to sign in to the AWS Management Console as the AWS account root user.

Note: If you previously signed in to the console with IAM user credentials, your browser might remember this preference and open your account-specific sign-in page. You cannot use the IAM user sign-in page to sign in with your AWS account root user credentials. If you see the IAM user sign-in page, choose Sign-in using root user credentials near the bottom of the page to return to the main sign-in page. From there, you can type your AWS account email address and password.

2. On the IAM Dashboard page, choose your account name in the navigation bar, and then choose My Security Credentials.
3. If you see a warning about accessing the security credentials for your AWS account, choose Continue to Security Credentials.
4. Expand the Access keys (access key ID and secret access key) section.
5. Choose Create New Access Key.
6. Then choose Download Key File to save the access key ID and secret access key to a file on your computer. After you close the dialog box, you can't retrieve this secret access key again.

To enable AWS keys backup

1. Click on the Enable checkbox and then enter your Access key and Secret key to finish setting up your Amazon S3 backups.

2. You can choose a bucket to save your backups to by entering that in the Bucket textbox. If you leave that box blank, a bucket will be generated for your Assembla backups.

3. Checking the Enable backup cleanup box will automatically delete old backup files (the age will be determined by your input into the accompanying textbox) on a weekly basis.

4. Click on the "Save Changes" button.

2. AWS S3 bucket policy

1. Sign in to the AWS Management Console and open the Amazon S3 console at

2. In the left navigation pane, choose Buckets.

3. Choose Create bucket. The Create bucket page opens.

4. For Bucket name, enter a name for your bucket. The bucket name must:

4.1. Be unique within a partition. A partition is a grouping of Regions. AWS currently has three partitions: aws (Standard Regions), aws-cn (China Regions), and aws-us-gov (AWS GovCloud (US) Regions).

4.2. Be between 3 and 63 characters long.

4.3. Consist only of lowercase letters, numbers, dots (.), and hyphens (-). For best compatibility, we recommend that you avoid using dots (.) in bucket names, except for buckets that are used only for static website hosting.

4.4. Begin and end with a letter or number.

After you create the bucket, you cannot change its name. For more information about naming buckets, see Bucket naming rules.

5. For Region, choose the AWS Region where you want the bucket to reside.

6. Under Block Public Access settings for this bucket, choose the Block Public Access settings that you want to apply to the bucket.

7. Choose Create bucket.

8. Go back to Amazon S3 console at

9. In the left navigation pane, choose Buckets.

10. In the Buckets list, choose the name of the bucket that you previously created.

11. Choose the Permissions tab.

12. Under Bucket policy, choose Edit. The Edit bucket policy page appears. Enter below policy and replace yourbucketnamehere with your bucket name.

"Version": "2012-10-17",
"Statement": [
"Sid": "AllowAssembla",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::366280538658:root"
"Action": [
"Resource": [

13. On the Assembla side, click on the "Use AWS S3 bucket policy" checkbox.

14. Click on the "Save Changes" button.

Need help? Contact us at

Did this answer your question?