Skip to main content

Setting Up Amazon S3 Backups

Toshi Dávila avatar
Written by Toshi Dávila
Updated today

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

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

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

Setting up backups using 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 IAM Dashboard, choose your account name in the navigation bar, and then click My Security Credentials.

  3. If you see a warning about accessing the security credentials for your AWS account, click Continue to Security Credentials.

  4. Expand the Access keys (access key ID and secret access key) section, and then click Create New Access Key.

  5. Click Download Key File to save the access key ID and secret access key to a file on your computer.
    ​Note: After you close the dialog box, you cannot retrieve this secret access key again.

To enable AWS keys backup

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

  2. Choose a bucket to save your backups to by entering that in the Bucket textbox. If you leave that box blank, a bucket is generated for your Assembla backups.

  3. Check Enable backup cleanup to automatically delete old backup files (the age is determined by your input into the accompanying textbox) on a weekly basis.

  4. Click Save Changes.
    ​

Setting up backups using AWS S3 bucket policy

To set up backups using AWS S3 bucket policy

  1. Log in to the AWS Management Console and open the Amazon S3 console at https://console.aws.amazon.com/s3/.

  2. In the left navigation pane, choose Buckets.

  3. Click Create bucket. The Create bucket page opens.

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

    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)

      • aws-us-gov (AWS GovCloud (US) Regions)

    2. be between 3 and 63 characters long.

    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. begin and end with a letter or number.

      After you create the bucket, you cannot change its name.

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

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

  7. Click Create bucket.

  8. Go back to Amazon S3 console at https://console.aws.amazon.com/s3/.

  9. In the left navigation pane, click Buckets.

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

  11. Click the Permissions tab.

  12. Under Bucket policy, click Edit. The Edit bucket policy page appears.

  13. Type the policy below and replace yourbucketnamehere with your bucket name.
    ​

    {
     "Version": "2012-10-17",
     "Statement": [
      {
       "Sid": "AllowAssembla",
       "Effect": "Allow",
       "Principal": {
        "AWS": "arn:aws:iam::366280538658:root"
       },
       "Action": [
        "s3:DeleteObject",
        "s3:DeleteObjectVersion",
        "s3:GetBucketLocation",
        "s3:GetObject",
        "s3:GetObjectVersion",
        "s3:ListBucket",
        "s3:ListBucketVersions",
        "s3:PutObject",
        "s3:PutObjectAcl"
       ],
       "Resource": [
        "arn:aws:s3:::yourbucketnamehere",
        "arn:aws:s3:::yourbucketnamehere/*"
       ]
      }
     ]
    }

  14. On the Assembla side, click Use AWS S3 bucket policy.

  15. Click Save Changes.


​Need help? Contact us at support@assembla.com. 

Did this answer your question?